Method: resources.calendars.list

Ruft eine Liste der 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 anzugeben.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse.
orderBy

string

Feld(er), nach dem bzw. denen die Ergebnisse in aufsteigender oder absteigender Reihenfolge sortiert werden sollen. Zu den unterstützten Feldern gehören resourceId, resourceName, capacity, buildingId und floorName. Wenn keine Reihenfolge angegeben ist, wird standardmäßig die aufsteigende Reihenfolge verwendet. Muss folgendermaßen formatiert sein: „Feld [asc|desc], Feld [asc|desc], …“. Mit buildingId, capacity desc werden beispielsweise Ergebnisse zurückgegeben, die zuerst nach buildingId in aufsteigender Reihenfolge und dann nach capacity in absteigender Reihenfolge sortiert sind.
pageToken

string

Token, mit dem die nächste Seite in der Liste angegeben wird.
query

string

Stringabfrage zum Filtern von Ergebnissen. Muss das Format „Feld Operator Wert“ haben. Dabei kann „Feld“ jedes der unterstützten Felder und „Operator“ jeder der unterstützten Vorgänge sein. Zu den Operatoren gehören „=“ für die genaue Übereinstimmung, „!=“ für die Abweichung und „:“ für die Präfixübereinstimmung oder gegebenenfalls für die HAS-Übereinstimmung. Bei der Präfixübereinstimmung muss auf den Wert immer ein * folgen. Die logischen Operatoren „NICHT“ und „UND“ werden in dieser Prioritätsreihenfolge unterstützt. Zu den unterstützten Feldern gehören 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

Identifiziert dies als Sammlung von CalendarResources. Dies ist immer admin#directory#resources#calendars#calendarResourcesList.
etag

string

ETag der Ressource.
items[]

object (CalendarResource)

Die „CalendarResources“ auf dieser Ergebnisseite.
nextPageToken

string

Das Fortsetzungstoken, das zum Durchblättern großer Ergebnismengen 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.