Следите за изменениями в ресурсах ACL.
Запрос
HTTP-запрос
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch
Параметры
Имя параметра | Ценить | Описание |
---|---|---|
Параметры пути | ||
calendarId | string | Идентификатор календаря. Чтобы получить идентификаторы календаря, вызовите метод CalendarList.list . Если вы хотите получить доступ к основному календарю вошедшего в систему пользователя, используйте ключевое слово « primary ». |
Авторизация
Этот запрос требует авторизации со следующей областью действия:
Объем |
---|
https://www.googleapis.com/auth/calendar |
Дополнительную информацию см. на странице аутентификации и авторизации .
Тело запроса
В теле запроса укажите данные следующей структуры:
{ "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, в миллисекундах. Необязательный. |