Czekaj na zmiany w zasobach CalendarList.
Prośba
Żądanie HTTP
POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch
Parametry
Nazwa parametru | Wartość | Opis |
---|
Upoważnienie
To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:
Zakres |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.
Treść żądania
Dane w treści żądania muszą mieć taką strukturę:
{ "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, który identyfikuje ten kanał. | |
token |
string |
Dowolny ciąg znaków wysyłany na adres docelowy wraz z każdym powiadomieniem przesłanym na ten kanał. Opcjonalnie. | |
type |
string |
Typ mechanizmu przesyłania używany w tym kanale. Prawidłowe wartości to „web_hook ” (lub „webhook ”). Obie wartości odnoszą się do kanału, w którym żądania HTTP są używane do dostarczania wiadomości. |
|
address |
string |
Adres, na który są dostarczane powiadomienia dotyczące tego kanału. | |
params |
object |
Dodatkowe parametry kontrolujące zachowanie kanału wyświetlania. Opcjonalnie. | |
params.ttl |
string |
Wyrażony w sekundach czas życia danych dla kanału powiadomień. Wartość domyślna to 604 800 sekund. |
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź w następującej strukturze:
{ "kind": "api#channel", "id": string, "resourceId": string, "resourceUri": string, "token": string, "expiration": long }
nazwa usługi, | Wartość | Opis | Uwagi |
---|---|---|---|
kind |
string |
Określa go jako kanał powiadomień używany do monitorowania zmian w zasobie „api#channel ”. |
|
id |
string |
Identyfikator UUID lub podobny unikalny ciąg znaków, który identyfikuje ten kanał. | |
resourceId |
string |
Nieprzejrzysty identyfikator identyfikujący zasób, który chcesz oglądać na tym kanale. Stabilna w różnych wersjach interfejsu API. | |
resourceUri |
string |
Identyfikator wersji obserwowanego zasobu. | |
token |
string |
Dowolny ciąg znaków wysyłany na adres docelowy wraz z każdym powiadomieniem przesłanym na ten kanał. Opcjonalnie. | |
expiration |
long |
Data i godzina wygaśnięcia kanału powiadomień w milisekundach, w postaci sygnatury czasowej uniksowej. Opcjonalnie. |