Skip to content

获取会议室个性化配置

该接口用于获取会议室个性化配置。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/meeting_room/room/customization
HTTP MethodPOST
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用calendar:room 管理会议室信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求体

参数参数类型必须说明
room_idsarray<string>要获取的会议室ID列表

请求体示例

json
{
	"room_ids": [
  		"omm_2f3060afa404d3db7bb473xxxxxxxxxx"
  	]
}

响应

响应体

参数参数类型说明
error_room_ids-返回错误的入参
   ∟building_idstring建筑id
   ∟room_idstring会议室id
   ∟error_msgstring错误信息
room_id_to_customization-会议室ID-个性化配置的映射
∟room_idstring会议室ID
   ∟contact_idsarray<int64>准备会议室个性化的相关配置的人员ID列表
   ∟customization_data-个性化配置数据
      ∟conditions-问卷的显示条件,当条件满足时,该问卷才会出现让用户进行选择
         ∟custom_keystring该custom_key对应的index_key选中后,问卷才会显示
         ∟option_keysarray<string>所有的option都被选中后,问卷才会显示
      ∟customization_typeint问卷的类型,1表示单选,2表示多选,3表示填空
      ∟index_keystring每个问卷的独立id
      ∟input_contentstring当type类型为填空时,该参数需要填入
      ∟is_requiredbool当type类型为填空时,该参数需要填入
      ∟labelstring每个问卷的问题
      ∟options-每个问卷的选项
         ∟is_othersbool是否是其他选项
         ∟is_selectedbool该选项是否勾选
         ∟option_image_urlstring选项的图片
         ∟option_keystring每个选项的唯一id
         ∟option_labelstring每个问卷的选项
         ∟others_contentstring其他选项的输入内容
      ∟place_holderstring填空题在未填写时的填充文案
   ∟preparation_timeint准备时间

响应体示例

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
        }
    }
}

错误码

具体可参考:服务端错误码说明

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