服务端 API/日历/日历访问控制/访问控制资源介绍
# 访问控制资源介绍

访问控制（ACL）用于管理日历的成员权限。一个日历内可以创建多个 ACL，每一个 ACL 内可以为一个成员设置日历的访问权限，其中访问权限包括：

- 游客，只能看到日历日程忙闲信息
- 订阅者：可查看日历内的所有日程详情。
- 编辑者：可在日历内创建或修改日程。
- 管理员：可管理日历及共享设置。

##  字段说明

日历的访问控制资源包含的属性说明如下。

名称 | 类型 | 描述
---|---|---
acl_id | string | 单个日历内的 ACL 唯一标识，只读字段。不同日历实体下的 acl_id 可能重复。<br>**示例值**："user_6843287928157667331"<br>**获取方式**：[获取访问控制列表](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar-acl/list)
role | string | ACL 的访问级别，即成员对日历的访问权限。<br>**可选值有**：<br>- `free_busy_reader` 游客，只能看到忙碌、空闲信息。<br>- `reader` 订阅者，可查看所有日程详情。<br>- `writer` 编辑者，可创建及修改日程。<br>- `owner` 管理员，可管理日历及共享设置。<br>**示例值**：`owner`
scope | acl_scope | 权限生效范围。
&nbsp;&nbsp;&nbsp;&nbsp;∟type | string | 权限生效范围的类型。目前只支持选择 `user`。<br>**可选值有**：<br>- `user`：用户，用户资源定义可参见 [用户 User 资源概述](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/field-overview)。<br>**示例值**：`user`
&nbsp;&nbsp;&nbsp;&nbsp;∟user_id | string | 用户 ID。当 `type=user` 时，必须设置该参数值。关于用户 ID 的更多介绍可参见[用户相关的 ID 概念](https://open.larksuite.com/document/home/user-identity-introduction/introduction)。<br>**示例值**："ou_742b382643a4075545422e87ff0d31fb"

##  数据示例
```json
{
    "acl_id": "user_6843287928157667331",
    "role": "owner",
    "scope": {
        "type": "user",
        "user_id": "ou_742b382643a4075545422e87ff0d31fb"
    }
}
```