PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
Параметры
Имя параметра
Ценить
Описание
Параметры пути
calendarId
string
Идентификатор календаря. Для получения идентификаторов календаря вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего вошедшего в систему пользователя, используйте ключевое слово " primary ".
ruleId
string
Идентификатор правила ACL.
Необязательные параметры запроса
sendNotifications
boolean
Отправлять ли уведомления об изменении общего доступа к календарю. Обратите внимание, что нет уведомлений об удалении доступа. Необязательно. Значение по умолчанию — True.
Авторизация
Для этого запроса требуется авторизация по крайней мере в одной из следующих областей:
В теле запроса укажите ресурс 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 ниже, чтобы вызвать этот метод для реальных данных и увидеть ответ.
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
Параметры
Имя параметра
Ценить
Описание
Параметры пути
calendarId
string
Идентификатор календаря. Для получения идентификаторов календаря вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего вошедшего в систему пользователя, используйте ключевое слово " primary ".
ruleId
string
Идентификатор правила ACL.
Необязательные параметры запроса
sendNotifications
boolean
Отправлять ли уведомления об изменении общего доступа к календарю. Обратите внимание, что нет уведомлений об удалении доступа. Необязательно. Значение по умолчанию — True.
Авторизация
Для этого запроса требуется авторизация по крайней мере в одной из следующих областей:
В теле запроса укажите ресурс 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 ниже, чтобы вызвать этот метод для реальных данных и увидеть ответ.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# Acl: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates an access control rule.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| `ruleId` | `string` | ACL rule identifier. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|-------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.acls` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Required Properties** ||||\n| `scope` | `object` | The extent to which [calendar access](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars) is granted by this ACL rule. | |\n| scope.`type` | `string` | The type of the scope. Possible values are: - \"`default`\" - The public scope. This is the default value. - \"`user`\" - Limits the scope to a single user. - \"`group`\" - Limits the scope to a group. - \"`domain`\" - Limits the scope to a domain. Note: The permissions granted to the \"`default`\", or public, scope apply to any user, authenticated or not. | |\n| **Optional Properties** ||||\n| `role` | `string` | The role assigned to the scope. Possible values are: - \"`none`\" - Provides no access. - \"`freeBusyReader`\" - Provides read access to free/busy information. - \"`reader`\" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - \"`writer`\" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - \"`owner`\" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to manipulate ACLs. | writable |\n| scope.`value` | `string` | The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type \"`default`\". | writable |\n\nResponse\n--------\n\nIf successful, this method returns an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
