Method: resources.calendars.list

Ruft eine Liste von Kalenderressourcen für ein Konto ab

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Die eindeutige ID für das Google Workspace-Konto des Kunden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die Kundennummer Ihres Kontos darzustellen.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse;
orderBy

string

Felder, nach denen die Ergebnisse in aufsteigender oder absteigender Reihenfolge sortiert werden sollen. Unterstützte Felder sind resourceId, resourceName, capacity, buildingId und floorName. Wenn keine Reihenfolge angegeben ist, wird standardmäßig aufsteigend verwendet. Muss das Format „Feld [asc|desc]“, Feld [asc|desc], ...“ haben. Beispiel: buildingId, capacity desc gibt die Ergebnisse zuerst nach buildingId in aufsteigender Reihenfolge und dann nach capacity in absteigender Reihenfolge zurück.
pageToken

string

Token zur Angabe der nächsten Seite in der Liste.
query

string

Stringabfrage, die zum Filtern der Ergebnisse verwendet wird. Muss das Format „Feldoperatorwert“ haben, wobei das Feld ein beliebiges unterstütztes Feld und der Operator ein unterstützter Vorgang sein kann. Die Operatoren enthalten „=' für genaue Übereinstimmung, '!=' für nicht übereinstimmende Werte und ':' für eine Präfixübereinstimmung oder HAS-Übereinstimmung, sofern zutreffend. Bei einer Präfixübereinstimmung muss immer auf den Wert ein * folgen. Logische Operatoren NOT und AND werden in dieser Reihenfolge unterstützt. Unterstützte Felder sind generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail und resourceCategory. Beispiel: buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Öffentliche API: Resources.calendars

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (CalendarResource)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Kennzeichnet dies als Sammlung von CalendarResources. Das ist immer admin#directory#resources#calendars#calendarResourcesList.
etag

string

ETag der Ressource.
items[]

object (CalendarResource)

Die CalendarResources auf dieser Seite der Ergebnisse.
nextPageToken

string

Das Fortsetzungstoken, das zum Durchsuchen großer Ergebnissätze verwendet wird. Geben Sie diesen Wert in einer nachfolgenden Anfrage an, um die nächste Ergebnisseite zurückzugeben.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.