Szukaj zmian w zasobach listy kontroli dostępu.
Prośba
Żądanie HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Parametry ścieżki | ||
calendarId |
string |
Identyfikator kalendarza. Aby pobrać identyfikatory kalendarzy, wywołaj metodę calendarList.list. Jeśli chcesz uzyskać dostęp do kalendarza głównego aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary ”.
|
Upoważnienie
To żądanie wymaga autoryzacji w tym zakresie:
Zakres |
---|
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. |