此页面由 Cloud Translation API 翻译。

Acl: list

返回日历访问控制列表中的规则。立即试用。

请求

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

参数名称	值	说明
路径参数
`calendarId`	`string`	日历标识符。如需检索日历 ID，请调用 calendarList.list 方法。如果您想访问当前登录用户的主要日历，请使用“`primary`”关键字。
可选的查询参数
`maxResults`	`integer`	一个结果页面中返回的条目数上限。默认值为 100 个条目。每页数据大小不得超过 250 个条目。可选。
`pageToken`	`string`	用于指定要返回的结果页面的令牌。可选。
`showDeleted`	`boolean`	是否在结果中包含已删除的 ACL。已删除的 ACL 由等于“`none`”的 `role` 表示。如果提供了 `syncToken`，则始终会包含已删除的 ACL。可选。默认值为 False。
`syncToken`	`string`	从上一个列表请求的最后一页结果中返回的 `nextSyncToken` 字段中获取的令牌。这会使此列表请求的结果仅包含自那时起发生更改的条目。自上次列表请求之后删除的所有条目始终会出现在结果集中，并且不允许将 `showDeleted` 设置为 False。如果 `syncToken` 过期，服务器将返回 410 GONE 响应代码，客户端应清除其存储空间，并在不使用任何 `syncToken` 的情况下执行完整同步。详细了解增量同步。可选。默认是返回所有条目。

此请求需要获得以下至少一个范围的授权：

范围
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.acls`
`https://www.googleapis.com/auth/calendar.acls.readonly`

如需了解详情，请参阅身份验证和授权页面。

使用此方法时请勿提供请求正文。

如果成功，此方法将返回采用以下结构的响应正文：

{
  "kind": "calendar#acl",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    acl Resource
  ]
}

属性名称	值	说明
`kind`	`string`	集合类型（“`calendar#acl`”）。
`etag`	`etag`	集合的 ETag。
`nextPageToken`	`string`	用于访问此结果的下一页的令牌。如果没有更多结果，则省略此字段，在这种情况下，系统会提供 `nextSyncToken`。
`items[]`	`list`	访问控制列表中的规则列表。
`nextSyncToken`	`string`	在稍后的时间点用于仅检索自此结果返回后发生更改的条目。如果有更多结果，则省略此属性，并提供 `nextPageToken`。

使用下面的 API Explorer 对实际数据调用此方法，然后查看响应。