工具 API

calendar__query_busy_status

查询指定用户在给定时间范围内的闲忙状态,返回其日历中已占用时间段的详细日程信息(如标题、开始/结束时间),不包含具体日程内容细节(如参与人、地点),以保护隐私。结果受组织可见性策略控制:仅当调用者有权限查看该用户日历时方可获取有效数据。适用于安排会议前快速确认他人可用时间。

enterpriseOAuth1 积分

调用信息

工具标识
dingtalk.calendar__query_busy_status
服务提供方
钉钉
平均响应
555 ms
近 7 天调用
1

输入参数

endTime必填

查询的结束时间,时间戳(毫秒级)格式。

startTime必填

查询的开始时间,时间戳(毫秒级)格式。

userIds必填

用户uid列表最大长度 20。