Acl: update

Обновляет правило контроля доступа. Попробуйте прямо сейчас .

Запрос

HTTP-запрос 

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId

Параметры

Имя параметра Ценить Описание
Параметры пути
calendarId string Идентификатор календаря. Для получения идентификаторов календарей вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего пользователя, используйте ключевое слово " primary ".
ruleId string Идентификатор правила ACL.
Дополнительные параметры запроса
sendNotifications boolean Отправлять ли уведомления об изменении доступа к календарю. Обратите внимание, что уведомления об удалении доступа не отправляются. Необязательно. По умолчанию — True.

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей действия:

Объем
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

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

Текст запроса

В теле запроса укажите ресурс ACL со следующими свойствами:

Название объекта недвижимости Ценить Описание Примечания
Обязательные свойства
scope object В какой степени данное правило ACL предоставляет доступ к календарю .
scope. type string Тип области видимости. Возможные значения:
  • " default " — Общедоступная область видимости. Это значение по умолчанию.
  • " user " - Ограничивает область действия одним пользователем.
  • " group " — Ограничивает область действия группой.
  • " domain " — ограничивает область действия определенным доменом.
Примечание: Права доступа, предоставленные в рамках « default » или «общедоступной» области, распространяются на любого пользователя, независимо от того, авторизован он или нет.
Дополнительные свойства
role string Роль, назначенная для данной области действия. Возможные значения:
  • " none " - Не предоставляет доступа.
  • " freeBusyReader " — предоставляет доступ для чтения к информации о занятости/доступности.
  • " reader " — предоставляет доступ к календарю для чтения. Приватные события будут отображаться пользователям с доступом для чтения, но подробности событий будут скрыты.
  • Параметр " writerWithoutPrivateAccess " предоставляет доступ на чтение и запись к календарю. Приватные события будут отображаться пользователям с доступом writerWithoutPrivateAccess , но подробности событий будут скрыты.
  • " writer " — предоставляет доступ на чтение и запись к календарю. Частные события будут отображаться пользователям с правами записывающего, а также будут видны подробности событий. Предоставляет доступ на чтение к спискам контроля доступа (ACL) календаря.
  • « owner » — предоставляет менеджеру доступ к календарю. Эта роль обладает всеми правами доступа, что и роль писателя, а также возможностью изменять уровни доступа других пользователей.

 записываемый
scope. value string Адрес электронной почты пользователя или группы, либо имя домена, в зависимости от типа области действия. Опускается для типа " default ". записываемый

Ответ

В случае успеха этот метод возвращает ресурс ACL в теле ответа.

Попробуйте!

Воспользуйтесь приведенным ниже инструментом API Explorer, чтобы вызвать этот метод на реальных данных и увидеть ответ.