Settings: watch

Следите за изменениями в ресурсах настроек.

Запрос

HTTP-запрос

POST https://www.googleapis.com/calendar/v3/users/me/settings/watch

Параметры

Имя параметра Ценность Описание

Авторизация

Этот запрос требует авторизации по крайней мере в одной из следующих областей:

Сфера
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly

Дополнительные сведения см. на странице аутентификации и авторизации .

Тело запроса

В теле запроса укажите данные следующей структуры:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Имя свойства Ценность Описание Заметки
id string UUID или подобная уникальная строка, идентифицирующая этот канал.
token string Произвольная строка, доставляемая на целевой адрес с каждым уведомлением, доставляемым по этому каналу. По желанию.
type string Тип механизма доставки, используемый для этого канала. Допустимые значения: " web_hook " (или " webhook "). Оба значения относятся к каналу, где HTTP-запросы используются для доставки сообщений.
address string Адрес, по которому доставляются уведомления для этого канала.
params object Дополнительные параметры, управляющие поведением канала доставки. По желанию.
params. ttl string Время жизни в секундах для канала уведомлений. По умолчанию 604800 секунд.

Ответ

В случае успеха этот метод возвращает тело ответа со следующей структурой:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Имя свойства Ценность Описание Заметки
kind string Идентифицирует это как канал уведомлений, используемый для отслеживания изменений в ресурсе, который называется " api#channel ".
id string UUID или подобная уникальная строка, идентифицирующая этот канал.
resourceId string Непрозрачный идентификатор, идентифицирующий ресурс, просматриваемый на этом канале. Стабильный в разных версиях API.
resourceUri string Идентификатор версии отслеживаемого ресурса.
token string Произвольная строка, доставляемая на целевой адрес с каждым уведомлением, доставляемым по этому каналу. По желанию.
expiration long Дата и время истечения срока действия канала уведомления, выраженные в виде временной метки Unix в миллисекундах. По желанию.