Method: resources.calendars.list

Recupera una lista de recursos de calendario para una cuenta.

Solicitud HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customer

string

Es el ID único de la cuenta de Google Workspace del cliente. Como administrador de la cuenta, también puedes usar el alias my_customer para representar el ID de cliente de tu cuenta.

Parámetros de consulta

Parámetros
maxResults

integer

Cantidad máxima de resultados que se mostrarán.
orderBy

string

Son los campos por los que se ordenan los resultados, ya sea de forma ascendente o descendente. Los campos admitidos incluyen resourceId, resourceName, capacity, buildingId y floorName. Si no se especifica ningún orden, el valor predeterminado es ascendente. Debe tener el formato "campo [asc|desc], campo [asc|desc], …". Por ejemplo, buildingId, capacity desc devolvería resultados ordenados primero por buildingId en orden ascendente y, luego, por capacity en orden descendente.
pageToken

string

Es un token para especificar la siguiente página de la lista.
query

string

Es la cadena de consulta que se usa para filtrar los resultados. Contiene una o más cláusulas de búsqueda, cada una con un campo, un operador y un valor. Un campo puede ser cualquiera de los campos admitidos, y los operadores pueden ser cualquiera de las operaciones admitidas. Los operadores incluyen "=" para la concordancia exacta, "!=" para la no concordancia y ":" para la concordancia de prefijo o la concordancia HAS cuando corresponda. Para la coincidencia de prefijo, el valor siempre debe ir seguido de un asterisco (*). Se admiten los operadores lógicos NOT y AND (en este orden de precedencia). Los campos admitidos incluyen generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail y resourceCategory. Por ejemplo, buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

API pública: Resources.calendars

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (CalendarResource)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Identifica este objeto como una colección de CalendarResources. Siempre es admin#directory#resources#calendars#calendarResourcesList.
etag

string

ETag del recurso.
items[]

object (CalendarResource)

Son los CalendarResources en esta página de resultados.
nextPageToken

string

Es el token de continuación, que se usa para desplazarse por grandes conjuntos de resultados. Proporciona este valor en una solicitud posterior para mostrar la página siguiente de resultados.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://apps-apis.google.com/a/feeds/calendar/resource/
  • https://www.googleapis.com/auth/admin.directory.resource.calendar
  • https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

Para obtener más información, consulta la Guía de autorización.