Achten Sie auf Änderungen an Einstellungsressourcen.
Anfragen
HTTP-Anfrage
POST https://www.googleapis.com/calendar/v3/users/me/settings/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 |
https://www.googleapis.com/auth/calendar.settings.readonly |
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 } }
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
id |
string |
Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert. | |
token |
string |
Eine beliebige Zeichenfolge, die an die Zieladresse gesendet wird, wobei jede Benachrichtigung über diesen Kanal gesendet wird. Optional. | |
type |
string |
Der für diesen Kanal verwendete Übermittlungsmechanismus. Gültige Werte sind „web_hook “ (oder „webhook “). Beide Werte beziehen sich auf einen Kanal, bei dem HTTP-Anfragen zum Senden 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 Übermittlungskanals 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 |
Kennzeichnet dies als Benachrichtigungskanal, über den nach Änderungen an einer Ressource („api#channel “) gesucht wird. |
|
id |
string |
Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert. | |
resourceId |
string |
Eine intransparente ID, die die auf diesem Kanal beobachtete Ressource identifiziert. Stabil in verschiedenen API-Versionen. | |
resourceUri |
string |
Eine versionsspezifische Kennung für die beobachtete Ressource. | |
token |
string |
Eine beliebige Zeichenfolge, die an die Zieladresse gesendet wird, wobei jede Benachrichtigung über diesen Kanal gesendet wird. Optional. | |
expiration |
long |
Datum und Uhrzeit des Ablaufs des Benachrichtigungskanals in Millisekunden als Unix-Zeitstempel. Optional. |