预定会议室(Rooms)

最近更新时间:2024-06-07 09:11:01

我的收藏

接口描述

描述
对成功预定的会议添加会议室,支持多个会议室预定。此接口为覆盖型接口。
说明:
会议室预定对会议时长有硬性要求,会议时长不得大于24小时;不支持周期性会议。
通过会议 ID 预定会议室。
目前暂不支持 OAuth2.0 鉴权访问。
请求方式:POST
接口请求域名
https://api.meeting.qq.com/v1/meetings/{meeting_id}/book-rooms


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
meeting_id
String
会议 ID。
meeting_room_id_list
String 数组
会议室 ID 列表。
subject_visible
boolean
true:在会议开始前的一小时内,在 Room 上显示会议主题。默认值为 true。
false:在会议开始前的一小时内,在 Room 上不显示会议主题。
说明:该参数并不影响预定时间晚过当前时间一个小时以上的会议。超过一小时的会议默认不显示会议主题。

输出参数

参数名称
必选
参数类型
参数描述
meeting_room_number
Integer
会议室数量。
meeting_room_list
MeetingRoomList 对象数组
会议室对象列表。

MeetingRoomList 对象

参数名称
必选
参数类型
参数描述
meeting_room_id
String
会议室 ID。
meeting_room_name
String
会议室名称。
meeting_room_location
String
会议室地址。

错误码列表

状态码
错误码
错误描述
500
9007
会议已取消。
500
13001
缓存设置会议信息失败。
500
20000
请检查参数类型。
500
20001
会议时长不在24小时内,不允许预定会议室。
500
20201
查询会议室信息失败。
500
14151
会议已开始,不能修改会议信息。
500
21301
会议室已被占用。
500
20002
预定会议室不支持周期性会议。
400
190004
参数非法,请对照接口文档检查您的参数。
500
14152
会议已结束,不能修改会议信息。
500
20003
会议室未开放预定。
500
201003
会议信息不存在。
500
9102
无权限修改会议。

示例

输入示例

POST
https://api.meeting.qq.com/v1/meetings/6524541286408448530/book-rooms
{
"meeting_room_id_list":["100001","100002"]
}


输出示例

{
"meeting_room_number":2,
"meeting_room_list":[
{
"meeting_room_id":"100001",
"meeting_room_name":"会议室测试1",
"meeting_room_location":"广州-大厦-10"
},
{
"meeting_room_id":"100002",
"meeting_room_name":"会议室测试2",
"meeting_room_location":"西安-广场-19"
}
]
}