Events: watch

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Informacje o zmianach w zasobach dotyczących wydarzeń.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/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 obecnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.

Upoważnienie

To żądanie umożliwia autoryzację przy użyciu co najmniej jednego z tych zakresów:

Zakres
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania podaj dane o tej strukturze:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Nazwa właściwości Wartość Opis Uwagi
id string UUID lub podobny unikalny ciąg znaków identyfikujący ten kanał.
token string Dowolny ciąg znaków przesłany na adres docelowy wraz z każdym powiadomieniem dostarczonym przez ten kanał. Opcjonalne.
type string Typ mechanizmu przesyłania dla tego kanału. Prawidłowe wartości to „web_hook” (lub „webhook”). Obie te wartości odnoszą się do kanału, na którym do przesyłania wiadomości są używane żądania HTTPS.
address string Adres, na który są dostarczane powiadomienia z tego kanału.
params object Dodatkowe parametry kontrolujące działanie kanału dostarczania. Opcjonalne.
params.ttl string Czas życia kanału powiadomień w sekundach. Wartość domyślna to 604 800 sekund.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Nazwa właściwości Wartość Opis Uwagi
kind string Określa kanał jako kanał powiadomień używany do śledzenia zmian w zasobie, czyli „api#channel”.
id string UUID lub podobny unikalny ciąg znaków identyfikujący ten kanał.
resourceId string Nieprzejrzysty identyfikator identyfikujący zasób, który jest oglądany w tym kanale. Wersja stabilna w różnych wersjach interfejsu API.
resourceUri string Właściwy identyfikator obserwowanego zasobu.
token string Dowolny ciąg znaków przesłany na adres docelowy wraz z każdym powiadomieniem dostarczonym przez ten kanał. Opcjonalne.
expiration long Data i godzina wygaśnięcia kanału powiadomienia wyrażona w milisekundach jako sygnatura czasowa systemu Unix. Opcjonalne.