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”:向主管提供日历访问权限。此角色拥有撰写者角色的所有权限,并且还能够修改其他用户的访问权限级别。

可写入
scope object 相应 ACL 规则授予的日历访问权限的范围。
scope.type string 范围的类型。可能的值包括:
  • default” - 公开范围。这是默认值。
  • user” - 将范围限制为单个用户。
  • group” - 将范围限制为某个群组。
  • domain” - 将范围限制为某个网域。
注意:授予“default”(即公开)范围的权限适用于任何用户,无论其是否经过身份验证。
scope.value string 用户或群组的电子邮件地址,或网域的名称,具体取决于范围类型。已针对类型“default”省略。 可写入

方法

delete
删除访问权限控制规则。
get
返回访问权限控制规则。
insert
创建访问控制规则。
list
返回日历的访问控制列表中的规则。
patch
更新访问权限控制规则。此方法支持修补语义。请注意,每个 patch 请求会消耗 3 个配额单位;建议使用 get,然后使用 update。您指定的字段值会替换现有值。您未在请求中指定的字段将保持不变。如果指定了数组字段,则会覆盖现有数组;这会舍弃任何之前的数组元素。
update
更新访问权限控制规则。
观看
监视 ACL 资源的变化。