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 puede usar el alias my_customer para representar el ID de cliente de su 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 son resourceId, resourceName, capacity, buildingId y floorName. Si no se especifica ningún orden, el valor predeterminado es ascendente. Debe tener la forma "field [asc|desc], field [asc|desc], ...". Por ejemplo, buildingId, capacity desc mostraría 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 string que se usa para filtrar los resultados. Debe tener el formato "valor de 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 coincidencias exactas, “!='” para coincidencias y “:” para coincidencias de prefijos y O TIENE coincidencias cuando corresponda. Para la coincidencia de prefijo, el valor siempre debe estar seguido por *. Los operadores lógicos NOT y AND son compatibles (en este orden de precedencia). Los campos admitidos son 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 recursos de Calendario de 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 alcances 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.