工具 API
calendar_ _ query_ busy_ status
查询指定用户在给定时间范围内的闲忙状态,返回其日历中已占用时间段的详细日程信息(如标题、开始/结束时间),不包含具体日程内容细节(如参与人、地点),以保护隐私。结果受组织可见性策略控制:仅当调用者有权限查看该用户日历时方可获取有效数据。适用于安排会议前快速确认他人可用时间。
enterpriseOAuth1 积分
调用信息
- 工具标识
- dingtalk.calendar__query_busy_status
- 服务提供方
- 钉钉
- 平均响应
- 555 ms
- 近 7 天调用
- 1
输入参数
endTime必填查询的结束时间,时间戳(毫秒级)格式。
startTime必填查询的开始时间,时间戳(毫秒级)格式。
userIds必填用户uid列表最大长度 20。