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”- 提供日历的所有权。此角色拥有 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
更新访问权限控制规则。
手表
注意 ACL 资源的更改。