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

Campos para ordenar los resultados en orden 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á los resultados ordenados primero por buildingId en orden ascendente y, luego, por capacity en orden descendente.

pageToken

string

Token para especificar la página siguiente en la lista.

query

string

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 que no haya coincidencia y “:” para la coincidencia de prefijo o TIENE una coincidencia cuando corresponda. Para la coincidencia de prefijo, el valor siempre debe estar seguido de *. Se admiten los operadores lógicos NOT y AND (en este orden de prioridad). 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)

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.

Alcances 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.