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-01-14。
[null,null,["最后更新时间 (UTC):2025-01-14。"],[[["Resource representations define the structure of access control list (ACL) rules for Google Calendar, encompassing properties like `etag`, `id`, `kind`, `role`, and `scope`."],["`role` property dictates the level of access granted, ranging from no access (`none`) to full ownership (`owner`), influencing visibility and manipulation of calendar data."],["`scope` property determines the extent of access, targeting specific users, groups, domains, or the public (`default`), with varying implications for data sharing."],["Supported methods provide functionalities to manage ACL rules, including creating (`insert`), retrieving (`get`), updating (`update`, `patch`), deleting (`delete`), listing (`list`), and watching for changes (`watch`)."]]],[]]