常见问题

日历常见问题

Q：如何获取日历订阅列表

可以通过获取日历列表获取。该接口拉取到的日历为用户当前已经订阅的日历。

Q：如何通过开放平台预定会议室

创建日程后添加会议室参与人，而非创建日程时传入location字段。

Q：预定会议室时没有日程冲突仍然预定失败

可能有多种原因，包括但不限于：

会议室为审批会议室，因为openApi未支持审批功能，所以在管理后台打开会议室审批开关后，用户发起预定请求会失败。

会议室时间范围限制。当用户在管理后台开启了预定时间限制后，不满足限制会失败。举例：开启后，每日预定时间范围为06:00-18:00, 此时预定03:00-04:00时间段的会议室就会失败。

会议室用户可预定范围限制。如在管理后台设置了可预定范围后，发现当前用户并未在可预定范围内，会被拒绝。

并发预定会议室，其他用户先定上了会议室，因为两个请求间隔时间较短，会导致用户获取会议室忙闲时，会议室未被预定，但实际已被预定的情况。

Q：获取一段时间内日程，单次不能获取全部，再次调用传syncToken不起作用

接口中开始/结束时间和syncToken不能同时使用,代表两种不同的同步方式。

开始/结束时间用来获取一段时间内日历上的日程，如获取2021-11-01 00:00:00到2021-11-02 00:00:00的日程。具体样例参照获取日程列表。

syncToken根据日程版本号获取日程列表。每一次日程相关信息更新都会更新版本号。使用syncToken可以拉下syncToken代表版本号后发生变动的日程。具体样例参照获取日程列表。

Q：能看见日程返回，为何无法看见日程标题

对应接口：

获取日程和获取日程列表

能否看到日程标题和两个权限相关。

日程公开范围（visibility)

public：公开，默认显示日程详情

default：默认权限，用户有reader权限可以查看详情

private：私密，用户有reader权限不能查看详情

用户对日程所在日历的权限(role，对当前日历权限见获取日历接口)

unknown：未知权限（不考虑当前role）

free_busy_reader：游客，只能看到忙碌/空闲信息

reader：订阅者，查看所有日程详情

writer：编辑者，创建及修改日程

owner：管理员，管理日历及共享设置

当日程公开范围为public，用户对当前日历无论为何种权限均可见标题

当日程公开范围为private，用户对当前日历为writer和owner时可见标题

当日程公开范围为default, 用户对当前日历为reader，writer和owner时可见标题

Q：为什么不能编辑日程标题或删除日程

当用户为日程参与人时，可以在自己的主日历上获取到日程。但能看到不代表有日程的编辑权限。可参考下列接口中注意事项。

编辑日程权限

删除日程权限

判断当前用户是否为日程组织者，可参考Q：如何判断当前用户是否为日程组织者

判断当前用户对日历权限，可参考：获取日历接口

Q：如何判断当前用户是否为日程组织者

目前可通过获取参与人列表接口获取。

路径参数中，calendar_id传当前用户主日历id。

当能获取到参与人列表，且参与人中标记is_organizer: true的用户与当前用户身份匹配时，当前用户为日程的组织者。

Q：能否查询法定工作日, 节假日安排

飞书日历不提供法定工作日,节假期的查询功能; 但是如果已知有对应内容的日历, 可以通过搜索日历API 找到对应日历, 再通过获取日程列表API获取对应日程数据, 自行判断。

Q：是否支持订阅参与人回复接受, 拒绝等操作的变更事件

飞书日历支持订阅日程变更事件, 而参与人点击接受拒绝等操作带来的数据变更, 已经包含在日程变更事件的范围内, 直接订阅日程变更事件即可。

Q：重复性日程为什么只能获取到一个日程

重复性日程是通过日程Rrule字段表示重复规则的,详细定义可以参考RFC5545协议; 例如每天重复一次的日程对应RRULE: FREQ=DAILY;UNTIL=20220531T155959Z;INTERVAL=1。

Q：接口调用返回了错误码如何使用

查询飞书开放平台对应服务端错误码说明, 内容较多, 建议配合网页搜索功能使用。

Q: 会议室预定成功与否与日程关系

预定会议室需要通过创建日程参与人接口, 将要预约的会议室以参与人的身份进行保存, 即完成了一次预约动作; 会议室预约成功的前提是要先有日程, 最终是否预约成功, 还取决于其他用户的预约, 会议室是否需要审批, 租户级别对会议室可预约范围, 时长等众多因素。

此外还需注意如果使用应用身份预约, 需要上传operate_id字段:

Q: 通过接口设置了日程颜色, 其他人看了不起作用

日程的颜色, 仅对当前身份生效; 如果需要影响其他人看到的颜色, 需要用对方的身份来修改; 类似的字段还有 reminder (日程提醒)。

Q: 飞书客户端上绑定了三方日历 (Google/Exchange), API可以操作解绑吗

目前支持Exchange账号的绑定,解绑操作,需要租户超级管理员权限。

Google的暂不支持。

Q: 预约会议室之后, 为什么不能立刻知道是否预约成功

预约会议室是一个异步过程, 也可能涉及到和其他用户的竞争抢占, 在预约会议室操作提交之后几秒之内会变成最终失败或者成功的状态。

日历常见问题#

Q：如何获取日历订阅列表#

Q：如何通过开放平台预定会议室#

Q：预定会议室时没有日程冲突仍然预定失败#

Q：获取一段时间内日程，单次不能获取全部，再次调用传syncToken不起作用#

Q：能看见日程返回，为何无法看见日程标题#

Q：为什么不能编辑日程标题或删除日程#

Q：如何判断当前用户是否为日程组织者#

Q：能否查询法定工作日, 节假日安排#

Q：是否支持订阅参与人回复接受, 拒绝等操作的变更事件#

Q：重复性日程为什么只能获取到一个日程#

Q：接口调用返回了错误码如何使用#

Q: 会议室预定成功与否与日程关系#

Q: 通过接口设置了日程颜色, 其他人看了不起作用#

Q: 飞书客户端上绑定了三方日历 (Google/Exchange), API可以操作解绑吗#

Q: 预约会议室之后, 为什么不能立刻知道是否预约成功#