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 des Google Workspace-Kontos des Kunden. Als Kontoadministrator können Sie den Alias my_customer auch für die Kundennummer Ihres Kontos verwenden.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse;
orderBy

string

Feld(er) zum Sortieren der Ergebnisse in aufsteigender oder absteigender Reihenfolge. Unterstützte Felder sind resourceId, resourceName, capacity, buildingId und floorName. Wenn keine Reihenfolge angegeben ist, wird standardmäßig aufsteigend verwendet. Muss die Form „Feld [asc|desc], Feld [asc|desc], ...“ haben. buildingId, capacity desc gibt beispielsweise Ergebnisse zurück, die zuerst nach buildingId in aufsteigender Reihenfolge und dann in absteigender Reihenfolge nach capacity sortiert werden.
pageToken

string

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

string

Stringabfrage, die zum Filtern von Ergebnissen verwendet wird. Muss die Form „Feldoperatorwert“ haben, wobei das Feld beliebige unterstützte Felder und Operatoren beliebige unterstützte Vorgänge sein können. Operatoren umfassen „=“ für genaue Übereinstimmung, „!=' für nicht übereinstimmende Präfixe und „:“ für Präfixübereinstimmung oder HAS-Übereinstimmung (falls zutreffend). Für den Präfixabgleich muss dem Wert immer ein * folgen. Logische Operatoren NOT und AND werden unterstützt (in dieser Reihenfolge). 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

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

string

Bezeichnet dies als eine Sammlung von Kalenderressourcen. Der Wert ist immer admin#directory#resources#calendars#calendarResourcesList.
etag

string

Das ETag der Ressource.
items[]

object (CalendarResource)

Die Kalenderressourcen auf dieser Ergebnisseite.
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.