Acl: watch

Следите за изменениями в ресурсах 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 в миллисекундах. По желанию.