CalendarList: watch

Achten Sie auf Änderungen an CalendarList-Ressourcen.

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch

Parameter

Parametername Wert Beschreibung

Autorisierung

Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

Umfang
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext Daten mit der folgenden Struktur ein:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Name der Eigenschaft Wert Beschreibung Hinweise
id string Ein UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert.
token string Beliebiger String, der bei jeder Benachrichtigung über diesen Kanal an die Zieladresse gesendet wird. Optional.
type string Die Art des Auslieferungsmechanismus, der für diesen Kanal verwendet wird. Gültige Werte: "web_hook" (oder „webhook“). Beide Werte beziehen sich auf einen Kanal, in dem HTTP-Anfragen zum Zustellen von Nachrichten verwendet werden.
address string Die Adresse, an die Benachrichtigungen für diesen Kanal gesendet werden.
params object Zusätzliche Parameter, die das Verhalten des Auslieferungschannels steuern. Optional.
params.ttl string Die Gültigkeitsdauer in Sekunden für den Benachrichtigungskanal. Der Standardwert ist 604.800 Sekunden.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string Gibt an, dass dies den Benachrichtigungskanal „api#channel“ ist, über den nach Änderungen an einer Ressource gesucht wird.
id string Ein UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert.
resourceId string Eine intransparente ID, die die auf diesem Kanal beobachtete Ressource identifiziert. Stabil bei verschiedenen API-Versionen.
resourceUri string Eine versionsspezifische Kennung für die beobachtete Ressource.
token string Beliebiger String, der bei jeder Benachrichtigung über diesen Kanal an die Zieladresse gesendet wird. Optional.
expiration long Datum und Uhrzeit des Ablaufs des Benachrichtigungskanals, ausgedrückt als Unix-Zeitstempel in Millisekunden. Optional.