Method: resources.calendars.list

Récupère la liste des ressources d'agenda pour un compte.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter l'ID client de votre compte.

Paramètres de requête

Paramètres
maxResults

integer

Nombre maximal de résultats à renvoyer.
orderBy

string

Champ(s) selon lesquels trier les résultats par ordre croissant ou décroissant. Les champs acceptés incluent resourceId, resourceName, capacity, buildingId et floorName. Si aucun ordre n'est spécifié, l'ordre ascendant est utilisé par défaut. Doit être au format "field [asc|desc], field [asc|desc], ...". Par exemple, buildingId, capacity desc renverrait des résultats triés d'abord par buildingId par ordre croissant, puis par capacity par ordre décroissant.
pageToken

string

Jeton permettant de spécifier la page suivante de la liste.
query

string

Chaîne de requête utilisée pour filtrer les résultats. Contient une ou plusieurs clauses de recherche, chacune avec un champ, un opérateur et une valeur. Un champ peut être n'importe quel champ accepté, et un opérateur peut être n'importe quelle opération acceptée. Les opérateurs incluent "=" pour une correspondance exacte, "!=" pour une non-correspondance et ":" pour une correspondance de préfixe ou une correspondance HAS, le cas échéant. Pour la correspondance de préfixe, la valeur doit toujours être suivie d'un astérisque. Les opérateurs logiques NOT et AND sont acceptés (dans cet ordre de priorité). Les champs acceptés incluent generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail et resourceCategory. Par exemple, buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

API publique : Resources.calendars

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (CalendarResource)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Identifie cette ressource comme une collection de CalendarResources. Cette valeur est toujours admin#directory#resources#calendars#calendarResourcesList.
etag

string

ETag de la ressource.
items[]

object (CalendarResource)

Ressources d'agenda sur cette page de résultats.
nextPageToken

string

Jeton de continuité servant à parcourir les ensembles de résultats volumineux. Indiquez cette valeur dans une requête ultérieure pour renvoyer la page de résultats suivante.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide d'autorisation.