获取会议室个性化配置
该接口用于获取会议室个性化配置。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/meeting_room/room/customization |
| HTTP Method | POST |
| 支持的应用类型 | custom |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | calendar:room 管理会议室信息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
请求体
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| room_ids | array<string> | 是 | 要获取的会议室ID列表 |
请求体示例
json
{
"room_ids": [
"omm_2f3060afa404d3db7bb473xxxxxxxxxx"
]
}响应
响应体
| 参数 | 参数类型 | 说明 |
|---|---|---|
| error_room_ids | - | 返回错误的入参 |
| ∟building_id | string | 建筑id |
| ∟room_id | string | 会议室id |
| ∟error_msg | string | 错误信息 |
| room_id_to_customization | - | 会议室ID-个性化配置的映射 |
| ∟room_id | string | 会议室ID |
| ∟contact_ids | array<int64> | 准备会议室个性化的相关配置的人员ID列表 |
| ∟customization_data | - | 个性化配置数据 |
| ∟conditions | - | 问卷的显示条件,当条件满足时,该问卷才会出现让用户进行选择 |
| ∟custom_key | string | 该custom_key对应的index_key选中后,问卷才会显示 |
| ∟option_keys | array<string> | 所有的option都被选中后,问卷才会显示 |
| ∟customization_type | int | 问卷的类型,1表示单选,2表示多选,3表示填空 |
| ∟index_key | string | 每个问卷的独立id |
| ∟input_content | string | 当type类型为填空时,该参数需要填入 |
| ∟is_required | bool | 当type类型为填空时,该参数需要填入 |
| ∟label | string | 每个问卷的问题 |
| ∟options | - | 每个问卷的选项 |
| ∟is_others | bool | 是否是其他选项 |
| ∟is_selected | bool | 该选项是否勾选 |
| ∟option_image_url | string | 选项的图片 |
| ∟option_key | string | 每个选项的唯一id |
| ∟option_label | string | 每个问卷的选项 |
| ∟others_content | string | 其他选项的输入内容 |
| ∟place_holder | string | 填空题在未填写时的填充文案 |
| ∟preparation_time | int | 准备时间 |
响应体示例
json
{
"error_room_ids": [
{
"building_id": "",
"error_msg": "",
"room_id": ""
},
{
"building_id": "",
"error_msg": "",
"room_id": ""
}
],
"room_id_to_customization": {
"room_id": {
"contact_ids": [
"",
""
],
"customization_data": [
{
"conditions": [
{
"custom_key": "",
"option_keys": [
"",
""
]
},
{
"custom_key": "",
"option_keys": [
"",
""
]
}
],
"customization_type": 0,
"index_key": "",
"input_content": "",
"is_required": true,
"label": "",
"options": [
{
"is_others": true,
"is_selected": true,
"option_image_url": "",
"option_key": "",
"option_label": "",
"others_content": ""
},
{
"is_others": true,
"is_selected": true,
"option_image_url": "",
"option_key": "",
"option_label": "",
"others_content": ""
}
],
"place_holder": ""
}
],
"preparation_time": 0
}
}
}错误码
具体可参考:服务端错误码说明
