Следите за изменениями в ресурсах настроек.
Запрос
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, в миллисекундах. Необязательный. |