Acl: insert

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

Запрос

HTTP-запрос 

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

Параметры

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

Авторизация

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

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

Более подробную информацию смотрите на странице аутентификации и авторизации .

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

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

Имя объекта недвижимости Ценить Описание Примечания
Требуемые свойства
role string Роль, назначенная области действия. Возможные значения:
  • « none » — не предоставляет доступа.
  • « freeBusyReader » — обеспечивает доступ для чтения к информации о занятости.
  • « reader » — предоставляет доступ для чтения к календарю. Закрытые мероприятия будут видны пользователям с доступом для чтения, но подробности о мероприятиях будут скрыты.
  • « writer » — предоставляет доступ на чтение и запись в календарь. Закрытые мероприятия будут видны пользователям с доступом на запись, а также будут видны подробности мероприятий. Предоставляет доступ на чтение списков контроля доступа (ACL) календаря.
  • « owner » — предоставляет доступ к календарю на уровне менеджера. Эта роль обладает всеми полномочиями роли автора, а также возможностью изменять уровни доступа других пользователей.

 записываемый
scope object Степень, в которой доступ к календарю предоставляется данным правилом ACL.
scope. type string Тип области действия. Возможные значения:
  • « default » — публичная область действия. Это значение по умолчанию.
  • « user » — ограничивает область действия одним пользователем.
  • « group » — ограничивает область действия группой.
  • « domain » — ограничивает область действия доменом.
Примечание: разрешения, предоставленные области действия « default » или публичной области действия, применяются к любому пользователю, независимо от того, аутентифицирован он или нет.
Дополнительные свойства
scope. value string Адрес электронной почты пользователя или группы, либо имя домена, в зависимости от типа области действия. Не указывается для типа « default ». записываемый

Ответ

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

Попробуйте!

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