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 " - Предоставляет доступ для чтения к календарю. Частные события будут видны пользователям с доступом для чтения, но подробности событий будут скрыты.
  • " writer " - Предоставляет доступ на чтение и запись в календарь. Частные события будут видны пользователям с доступом на запись, а также будут видны подробности событий. Предоставляет доступ на чтение к ACL календаря.
  • " owner " - Предоставляет право собственности на календарь. Эта роль имеет все разрешения роли писателя с дополнительной возможностью манипулировать ACL.
 записываемый
scope. value string Адрес электронной почты пользователя или группы, или имя домена, в зависимости от типа области действия. Опущено для типа " default ". записываемый

Ответ

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

Попробуйте!

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

,

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

Запрос

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 " - Предоставляет доступ для чтения к календарю. Частные события будут видны пользователям с доступом для чтения, но подробности событий будут скрыты.
  • " writer " - Предоставляет доступ на чтение и запись в календарь. Частные события будут видны пользователям с доступом на запись, а также будут видны подробности событий. Предоставляет доступ на чтение к ACL календаря.
  • " owner " - Предоставляет право собственности на календарь. Эта роль имеет все разрешения роли писателя с дополнительной возможностью манипулировать ACL.
 записываемый
scope. value string Адрес электронной почты пользователя или группы, или имя домена, в зависимости от типа области действия. Опущено для типа " default ". записываемый

Ответ

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

Попробуйте!

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