śledzić zmiany w zasobach CalendarList.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch
Parametry
Nazwa parametru | Wartość | Opis |
---|
Autoryzacja
Ta prośba wymaga autoryzacji z co najmniej jednym z tych zakresów:
Zakres |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.calendarlist |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.
Treść żądania
Dane w treści żądania muszą mieć poniższy format:
{ "id": string, "token": string, "type": string, "address": string, "params": { "ttl": string } }
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
id |
string |
Identyfikator UUID lub podobny unikalny ciąg znaków identyfikujący ten kanał. | |
token |
string |
dowolny ciąg znaków dostarczany na adres docelowy wraz z każdym powiadomieniem wysyłanym przez ten kanał. Opcjonalnie: | |
type |
string |
Typ mechanizmu wyświetlania używanego na tym kanale. Prawidłowe wartości to „web_hook ” (lub „webhook ”). Obie wartości odnoszą się do kanału, w którym do przesyłania wiadomości używane są żądania HTTP. |
|
address |
string |
Adres, na który wysyłane są powiadomienia z tego kanału. | |
params |
object |
Dodatkowe parametry kontrolujące działanie kanału dostawczego. Opcjonalnie: | |
params.ttl |
string |
Czas życia w sekundach dla kanału powiadomień. Wartość domyślna to 60 4800 sekund. |
Odpowiedź
Jeśli operacja się powiedzie, metoda zwróci odpowiedź o tej strukturze:
{ "kind": "api#channel", "id": string, "resourceId": string, "resourceUri": string, "token": string, "expiration": long }
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
kind |
string |
Określa ten kanał powiadomień jako kanał używany do sprawdzania zmian w zasobach (wartość „api#channel ”). |
|
id |
string |
Identyfikator UUID lub podobny unikalny ciąg znaków identyfikujący ten kanał. | |
resourceId |
string |
Nieczytelny identyfikator identyfikujący zasób odtwarzany na tym kanale. stabilny w różnych wersjach interfejsu API; | |
resourceUri |
string |
Identyfikator wersji zasobu monitorowanego. | |
token |
string |
dowolny ciąg znaków dostarczany na adres docelowy wraz z każdym powiadomieniem wysyłanym przez ten kanał. Opcjonalnie: | |
expiration |
long |
Data i godzina wygaśnięcia kanału powiadomień wyrażona jako sygnatura czasowa systemu UNIX w milisekundach. Opcjonalnie: |