Acl
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}| Имя свойства | Ценить | Описание | Примечания |
|---|
etag | etag | ETag ресурса. | |
id | string | Идентификатор правила списка управления доступом (ACL). См. раздел Общий доступ к календарям . | |
kind | string | Тип ресурса (" calendar#aclRule "). | |
role | string | Роль, назначенная области. Возможные значения:- «
none » — не предоставляет доступа. - «
freeBusyReader » — обеспечивает доступ для чтения к информации о занятости. - «
reader » — обеспечивает доступ для чтения календаря. Частные события будут видны пользователям с доступом для чтения, но подробности о них будут скрыты. - «
writer » — обеспечивает доступ к календарю для чтения и записи. Частные события будут видны пользователям с правами записи, а подробности событий будут видны. Предоставляет доступ для чтения к спискам управления доступом календаря. - «
owner » — указывает право собственности на календарь. Эта роль имеет все разрешения роли писателя с дополнительной возможностью манипулировать списками управления доступом.
| записываемый |
scope | object | Степень, в которой доступ к календарю предоставляется этим правилом ACL. | |
scope. type | string | Тип области. Возможные значения:- «
default » — публичная область действия. Это значение по умолчанию. - «
user » — ограничивает область действия одним пользователем. - «
group » — ограничивает область действия группой. - «
domain » — ограничивает область действия доменом.
Примечание. Разрешения, предоставленные для области « default », или общедоступной, применяются к любому пользователю, прошедшему проверку подлинности или нет. | |
scope. value | string | Адрес электронной почты пользователя или группы или имя домена в зависимости от типа области. Опущено для типа « default ». | записываемый |
Методы
- удалить
- Удаляет правило контроля доступа.
- получать
- Возвращает правило контроля доступа.
- вставлять
- Создает правило контроля доступа.
- список
- Возвращает правила в списке управления доступом для календаря.
- пластырь
- Обновляет правило контроля доступа. Этот метод поддерживает семантику исправлений. Обратите внимание, что каждый запрос на исправление использует три единицы квоты; предпочитайте использовать
get за которым следует update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не укажете в запросе, остаются без изменений. Поля массива, если они указаны, перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива. - обновлять
- Обновляет правило контроля доступа.
- смотреть
- Следите за изменениями в ресурсах ACL.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# Acl\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"kind\": \"calendar#aclRule\",\n \"etag\": etag,\n \"id\": string,\n \"scope\": {\n \"type\": string,\n \"value\": string\n },\n \"role\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the Access Control List (ACL) rule. See [Sharing calendars](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars). | |\n| `kind` | `string` | Type of the resource (\"`calendar#aclRule`\"). | |\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` | `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| 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\nMethods\n-------\n\n[delete](/workspace/calendar/api/v3/reference/acl/delete)\n: Deletes an access control rule.\n\n[get](/workspace/calendar/api/v3/reference/acl/get)\n: Returns an access control rule.\n\n[insert](/workspace/calendar/api/v3/reference/acl/insert)\n: Creates an access control rule.\n\n[list](/workspace/calendar/api/v3/reference/acl/list)\n: Returns the rules in the access control list for the calendar.\n\n[patch](/workspace/calendar/api/v3/reference/acl/patch)\n: Updates an access control rule. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/acl/update)\n: Updates an access control rule.\n\n[watch](/workspace/calendar/api/v3/reference/acl/watch)\n: Watch for changes to ACL resources."]]
