日历访问控制 - 用户令牌

IFeishuUserV4CalendarAcl

功能描述

以用户身份管理日历的访问控制（ACL）成员权限。支持创建、删除、查询访问控制列表，以及订阅/取消订阅日历访问控制变更事件。权限角色包括：游客、订阅者、编辑者、管理员。

参考文档

• 日历访问控制概述

函数列表

函数名称	功能描述	认证方式	HTTP 方法
CreateCalendarAclAsync	创建访问控制	用户令牌	POST
DeleteCalendarAclAsync	删除访问控制	用户令牌	DELETE
GetCalendarAclsPageListAsync	分页获取访问控制列表	用户令牌	GET
SubscriptionCalendarAclAsync	订阅日历访问控制变更事件	用户令牌	POST
UnSubscriptionCalendarAclAsync	取消订阅日历访问控制变更事件	用户令牌	POST

函数详细内容

CreateCalendarAclAsync

以用户身份为指定日历添加访问控制，即日历成员权限。

函数签名

Task<FeishuApiResult<CreateCalendarAclResult>?> CreateCalendarAclAsync(
    string calendar_id,
    CreateCalendarAclRequest createCalendarAclRequest,
    string? user_id_type = "open_id",
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名	类型	必填	描述	示例
calendar_id	string	✅	日历 ID	feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn
createCalendarAclRequest	CreateCalendarAclRequest	✅	创建访问控制请求体	-
user_id_type	string	⚪	用户 ID 类型：open_id / union_id / user_id	open_id
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

代码示例

var request = new CreateCalendarAclRequest
{
    Role = "writer",
    Scope = new AclScope { Type = "user", UserId = "ou_xxx" }
};
var result = await api.CreateCalendarAclAsync(
    calendar_id: "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn",
    createCalendarAclRequest: request
);

---

DeleteCalendarAclAsync

以用户身份删除指定日历内的某一访问控制。

函数签名

Task<FeishuNullDataApiResult?> DeleteCalendarAclAsync(
    string calendar_id,
    string acl_id,
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名	类型	必填	描述	示例
calendar_id	string	✅	日历 ID	feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn
acl_id	string	✅	访问控制 ID	user_xxxxxx
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

代码示例

var result = await api.DeleteCalendarAclAsync(
    calendar_id: "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn",
    acl_id: "user_xxxxxx"
);

---

GetCalendarAclsPageListAsync

以用户身份分页获取指定日历的访问控制列表。

函数签名

Task<FeishuApiResult<GetCalendarEventPageListResult>?> GetCalendarAclsPageListAsync(
    string calendar_id,
    int page_size = 20,
    string? page_token = null,
    string? user_id_type = "open_id",
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名	类型	必填	描述	示例
calendar_id	string	✅	日历 ID	feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn
page_size	int	⚪	分页大小	20
page_token	string	⚪	分页标记	-
user_id_type	string	⚪	用户 ID 类型：open_id / union_id / user_id	open_id
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

代码示例

var result = await api.GetCalendarAclsPageListAsync(
    calendar_id: "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn",
    page_size: 20
);

---

SubscriptionCalendarAclAsync

以用户身份订阅指定日历下的访问控制变更事件。

函数签名

Task<FeishuNullDataApiResult?> SubscriptionCalendarAclAsync(
    string calendar_id,
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名	类型	必填	描述	示例
calendar_id	string	✅	日历 ID	feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

响应

{
  "code": 0,
  "msg": "success"
}

代码示例

var result = await api.SubscriptionCalendarAclAsync(
    calendar_id: "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn"
);

---

UnSubscriptionCalendarAclAsync

以用户身份取消订阅指定日历下的访问控制变更事件。

函数签名

Task<FeishuNullDataApiResult?> UnSubscriptionCalendarAclAsync(
    string calendar_id,
    CancellationToken cancellationToken = default);

认证 用户令牌

参数

参数名	类型	必填	描述	示例
calendar_id	string	✅	日历 ID	feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

代码示例

var result = await api.UnSubscriptionCalendarAclAsync(
    calendar_id: "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn"
);