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

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 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 mostraría resultados ordenados primero por buildingId en orden ascendente y, luego, por capacity en orden descendente.
pageToken

string

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

string

Es la consulta de cadena que se usa para filtrar los resultados. Debe tener el formato "valor del operador de campo", en el que el 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 HAS, cuando corresponda. En el caso de la concordancia de prefijos, el valor siempre debe ir seguido de un *. 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 esto como una colección de CalendarResources. Siempre es admin#directory#resources#calendars#calendarResourcesList.
etag

string

ETag del recurso.
items[]

object (CalendarResource)

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.