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 ”- 提供对日历的读写权限。不公开活动会向具有创作者访问权限的用户显示,并且活动详情也会显示。提供对日历 ACL 的读取权限。 - “
owner ”- 提供日历的所有权。此角色具有 writer 角色的所有权限,还具有操控 ACL 的额外权限。 |
可写入 |
scope |
object |
此 ACL 规则授予的日历访问权限范围。 |
|
scope.type |
string |
镜的类型。可能的值包括: - “
default ”- 公开范围。这是默认值。 - “
user ”- 将范围限制为单个用户。 - “
group ”- 将范围限制为一个群组。 - “
domain ”- 将范围限制为一个网域。 注意:授予“default ”(公开)范围的权限适用于任何用户(无论是否经过身份验证)。 |
|
scope.value |
string |
用户或群组的电子邮件地址,或域名(具体取决于范围类型)。针对类型“default ”省略。 |
可写入 |
方法
- delete
- 删除访问权限控制规则。
- get
- 返回访问权限控制规则。
- insert
- 创建访问控制规则。
- list
- 返回日历访问控制列表中的规则。
- patch
- 更新访问控制规则。此方法支持修补语义。请注意,每个补丁请求都会消耗三个配额单元;建议使用
get
后跟 update
。您指定的字段值会替换现有值。您在请求中未指定的字段将保持不变。数组字段(如果指定)会覆盖现有数组;这会舍弃之前的所有数组元素。
- update
- 更新访问权限控制规则。
- watch
- 监控 ACL 资源的更改。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],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."]]