Skip to content

Exchange 资源介绍

日历 API 提供了 Exchange 账户和飞书账户绑定、解绑以及状态查询的能力,你可以使用 API 将你的 Exchange 日历同步到飞书日历来使用。当 Exchange 账户绑定了飞书账户后,飞书账户会异步同步 Exchange 日历到飞书日历,同步期间你可以实时查询日历的同步状态。

字段说明

Exchange 绑定相关的 API 属性说明如下。

名称类型描述
exchange_binding_idstring创建 Exchange 绑定关系时产生的 ID,是 admin 账户、exchange 账户、用户三元组的唯一标识 ID。你可以通过该 ID 查询绑定关系、日历同步状态,或者解除绑定关系。 获取方式:调用将 Exchange 账户绑定到飞书账户接口时,从返回结果中获取。 示例值: "ZW1haWxfYWRtaW5fZXhhbXBsZUBvdXRsb29rLmNvbSBlbWFpbF9hY2NvdW50X2V4YW1wbGVAb3V0bG9vay5jb20="
admin_accountstringExchange 的 admin 账户。 示例值: "email_admin_example@outlook.com" 字段权限要求contact:user.email:readonly 获取用户邮箱信息
exchange_accountstring需绑定的 Exchange 账户。 示例值: "email_account_example@outlook.com" 字段权限要求contact:user.email:readonly 获取用户邮箱信息
user_idstring用户 ID,即 Exchange 账户绑定的飞书账户 ID。关于用户 ID 可参见用户相关的 ID 概念示例值:ou_xxxxxxxxxxxxxxxxxx
statusstringExchange 账户的同步状态。 可选值: - doing:日历正在同步 - cal_done:日历同步完成 - timespan_done:近期时间段同步完成 - done:日程同步完成 - err:同步错误 示例值:"doing"

数据示例

json
{
    "admin_account": "email_admin_example@outlook.com",
    "exchange_account": "email_account_example@outlook.com",
    "user_id": "ou_xxxxxxxxxxxxxxxxxx",
    "status": "doing",
    "exchange_binding_id": "ZW1haWxfYWRtaW5fZXhhbXBsZUBvdXRsb29rLmNvbSBlbWFpbF9hY2NvdW50X2V4YW1wbGVAb3V0bG9vay5jb20="
}

内容来源:飞书开放平台 · 自动爬取整理