Achten Sie auf Änderungen an Ereignisressourcen.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
calendarId |
string |
Kalender-ID. Rufen Sie zum Abrufen von Kalender-IDs die Methode calendarList.list auf. Wenn Sie auf den Hauptkalender des derzeit angemeldeten Nutzers zugreifen möchten, verwenden Sie die „primary “ Keyword.
|
Optionale Abfrageparameter | ||
eventTypes |
string |
Ereignistypen von zu überwachenden Ressourcen. Optional. Dieser Parameter kann mehrmals wiederholt werden, um Ressourcen verschiedener Typen zu beobachten. Wenn kein Wert festgelegt ist, werden alle Ereignistypen zurückgegeben.
Zulässige Werte sind: <ph type="x-smartling-placeholder">
|
Autorisierung
Diese Anfrage lässt eine Autorisierung mit mindestens einem der folgenden Bereiche zu:
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 } }
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 es sich hierbei um einen Benachrichtigungskanal handelt, der zum Überwachen von Änderungen an einer Ressource verwendet wird (api#channel ). |
|
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. |