Achten Sie auf Änderungen an Ereignisressourcen.
Anfragen
HTTP-Anfrage
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
calendarId |
string |
Kalender-ID. Rufen Sie die Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary “.
|
Optionale Suchparameter | ||
eventTypes |
string |
Der Ereignistyp wird für die Methode „watch“ ignoriert. |
Autorisierung
Diese Anfrage ermöglicht die Autorisierung mit mindestens einem der folgenden Bereiche:
Umfang |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events.readonly |
https://www.googleapis.com/auth/calendar.events |
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 } }
Attributname | Wert | Beschreibung | Hinweise |
---|---|---|---|
id |
string |
Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert. | |
token |
string |
Ein beliebiger String, der an die Zieladresse gesendet wird, wobei jede Benachrichtigung über diesen Kanal gesendet wird. Optional. | |
type |
string |
Die Art der Auslieferungsmethode, die für diesen Kanal verwendet wird. Gültige Werte sind „web_hook “ (oder „webhook “). Beide Werte beziehen sich auf einen Kanal, auf dem HTTP-Anfragen für die Zustellung 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 Bereitstellungskanals steuern. Optional. | |
params.ttl |
string |
Die Gültigkeitsdauer des Benachrichtigungskanals in Sekunden. 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 |
Kennzeichnet dies als Benachrichtigungskanal, über den nach Änderungen an einer Ressource gesucht wird (api#channel ). |
|
id |
string |
Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert. | |
resourceId |
string |
Eine intransparente ID, die die Ressource identifiziert, die auf diesem Kanal beobachtet wird. Stabile API-Versionen | |
resourceUri |
string |
Eine versionsspezifische Kennung für die beobachtete Ressource. | |
token |
string |
Ein beliebiger String, der an die Zieladresse gesendet wird, wobei jede Benachrichtigung über diesen Kanal gesendet wird. Optional. | |
expiration |
long |
Datum und Uhrzeit des Ablaufs des Benachrichtigungskanals, ausgedrückt als Unix-Zeitstempel in Millisekunden. Optional. |