ś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: |