腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 会议嘉宾管理 > 修改会议嘉宾列表

修改会议嘉宾列表

最近更新时间：2024-04-24 17:50:12

我的收藏

本页目录：

会议 ID 修改会议嘉宾列表

接口描述

描述：
通过会议 ID 修改会议嘉宾列表，只有会议创建人才有权限修改。
一天最多可设置嘉宾10次，且同一用户最多被设置为嘉宾10次。超出限制会议将不会出现在嘉宾会议列表中。
注意：
只有商业版、企业版或教育版用户可以使用会议嘉宾功能，免费版尚无此功能。
请求方式：PUT
接口请求域名：
https://api.meeting.qq.com/v1/guests/{meeting_id}

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_id
是
String
会议 ID。
userid
是
String
用户的 ID（企业内部请使用企业唯一用户标识，OAuth2.0 鉴权用户请使用 openId）。
instanceid
是
Integer
用户的终端设备类型：
0：PSTN
1：PC
2：Mac
3：Android
4：iOS
5：Web
6：iPad
7：Android Pad
8：小程序
9：voip、sip 设备
10：Linux
20：Rooms for Touch Windows
21：Rooms for Touch MacOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS
guests
是
Guest 对象数组
会议嘉宾列表（传空数组会清空嘉宾列表）。

Guest 对象

参数名称
必选
参数类型
参数描述
area
是
String
国家/地区代码（例如：中国传86，不是+86，也不是0086）。
phone_number
是
String
手机号。暂不支持固定电话号。
guest_name
否
String
嘉宾名称。

输出参数

无输出参数，成功返回空消息体，失败返回 错误码 和错误信息。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
500
9002
非法请求。
500
9042
无权限操作。
500
190001
用户未创建，请参考创建用户接口创建用户。
500
13703
查询会议失败。
500
190431
创建会议嘉宾失败。

示例

输入示例

PUT https://api.meeting.qq.com/v1/guests/15923312864334416762

{
    "meeting_id":"xxxxxxxxx",
    "userid":"xxx",
    "instanceid":1,
    "guests":[
        {
            "area":"86",
            "phone_number":"xxxxxxxxx",
            "guest_name":"xxxx"
        }
    ]
}

输出示例

更新成功，返回 body 为空。

会议 Code 修改会议嘉宾列表

接口描述

描述：
通过会议 Code 修改会议嘉宾列表，只有会议创建人才有权限修改。
一天最多可设置嘉宾10次，且同一用户最多被设置为嘉宾10次。超出限制会议将不会出现在嘉宾会议列表中。
注意：
只有商业版、企业版或教育版用户可以使用会议嘉宾功能，免费版尚无此功能。
请求方式：PUT
接口请求域名：
https://api.meeting.qq.com/v1/guests

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_code
是
String
会议码。
userid
是
String
用户的 ID（企业内部请使用企业唯一用户标识，OAuth2.0 鉴权用户请使用 openId）。
instanceid
是
Integer
用户的终端设备类型：
0：PSTN
1：PC
2：Mac
3：Android
4：iOS
5：Web
6：iPad
7：Android Pad
8：小程序
9：voip、sip 设备
10：Linux
20：Rooms for Touch Windows
21：Rooms for Touch MacOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS
guests
是
Guest 对象数组
会议嘉宾列表（传空数组会清空嘉宾列表）。

Guest 对象

参数名称
必选
参数类型
参数描述
area
是
String
国家/地区代码（例如：中国传86，不是+86，也不是0086）。
phone_number
是
String
手机号。暂不支持固定电话号。
guest_name
否
String
嘉宾名称。

输出参数

无输出参数，成功返回空消息体，失败返回 错误码 和错误信息。

错误码列表

状态码
错误码
错误描述
500
9003
会议信息不存在。
500
9002
非法请求。
500
9042
无权限操作。
500
13703
查询会议失败。
400
190004
参数非法，请对照接口文档检查您的参数。
500
190001
用户未创建，请参考创建用户接口创建用户。

示例

输入示例

PUT https://api.meeting.qq.com/v1/guests

{
    "meeting_code":"609685458",
    "userid":"xxxxx",
    "instanceid":1,
    "guests":[
        {
            "area":"86",
            "phone_number":"xxxxx",
            "guest_name":"xxxx"
        }
    ]
}


输出示例

更新成功，返回 body 为空。
中国站