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 Kunden-ID Ihres Kontos darzustellen.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse.
orderBy

string

Feld(er), 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 die aufsteigende Reihenfolge verwendet. Sollte das Format „Feld [asc|desc], Feld [asc|desc], …“ haben. Bei buildingId, capacity desc werden die Ergebnisse beispielsweise zuerst nach buildingId in aufsteigender Reihenfolge und dann nach capacity in absteigender Reihenfolge sortiert.
pageToken

string

Token zum Angeben der nächsten Seite in der Liste.
query

string

String-Abfrage zum Filtern von Ergebnissen. Enthält einen oder mehrere Suchbegriffe, die jeweils ein Feld, einen Operator und einen Wert enthalten. Ein Feld kann ein beliebiges unterstütztes Feld und ein Operator kann ein beliebiger unterstützter Vorgang sein. Zu den Operatoren gehören „=“ für die genaue Übereinstimmung, „!=“ für die Nichtübereinstimmung und „:“ für die Präfixübereinstimmung oder die HAS-Übereinstimmung, sofern zutreffend. Beim Präfixabgleich muss dem Wert immer ein Sternchen (*) folgen. Die logischen Operatoren NOT und AND werden unterstützt (in dieser Reihenfolge der Priorität). Unterstützte Felder sind generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail und resourceCategory. z. B. 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

Gibt an, dass es sich um eine Sammlung von CalendarResources handelt. 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 Autorisierungsleitfaden.