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 für die Kundennummer Ihres Kontos verwenden.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse.

orderBy

string

Feld(er), nach dem 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. Zum Beispiel würde buildingId, capacity desc Ergebnisse zurückgeben, die zuerst nach buildingId in aufsteigender Reihenfolge und dann nach capacity in absteigender Reihenfolge sortiert sind.

pageToken

string

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

query

string

Stringabfrage, die zum Filtern von Ergebnissen verwendet wird. Muss das Format „Feldoperatorwert“ haben Dabei kann das Feld ein beliebiges unterstütztes Feld sein und die Operatoren können beliebige unterstützte Vorgänge sein. Operatoren sind unter anderem '=' für genaue Übereinstimmung, '!=' für Abweichung und ':' für Präfixübereinstimmung oder HAS-Übereinstimmung, sofern zutreffend. Für einen Präfixabgleich sollte auf den Wert immer ein * folgen. Die logischen Operatoren NOT und AND werden unterstützt (in dieser Rangfolge). 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

Kennzeichnet es als eine Sammlung von CalendarResources. Dies ist immer admin#directory#resources#calendars#calendarResourcesList.

etag

string

Das 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.