腾讯会议
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 网络研讨会（Webinar）管理 > 修改网络研讨会嘉宾列表

修改网络研讨会嘉宾列表

最近更新时间：2024-04-23 16:12:02

我的收藏

本页目录：

接口描述

描述：修改指定的网络研讨会嘉宾列表，只有网络研讨会的创建者才有权限修改。
请求方式：PUT
接口请求域名：
https://api.meeting.qq.com/v1/webinars/{meeting_id}/guests

输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_id
是
String
网络研讨会唯一标识。
userid
是
String
调用方用于标示用户的唯一 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。
企业唯一用户标识说明：
1：企业对接 SSO 时使用的员工唯一标识 ID。
2：企业调用创建用户接口时传递的 userid 参数。
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 对象数组
网络研讨会嘉宾列表。一次最多支持添加200个对象。

Guest 对象

参数名称
必选
参数类型
参数描述
guest_type
是
Integer
嘉宾类型：
1：内部嘉宾
2：外部嘉宾
userid
否
String
用户的唯一 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。内部嘉宾使用该字段，忽略其他字段。
area
否
String
国家/地区代码，外部嘉宾必填（例如：中国传86，不是+86）。
phone_number
否
String
手机号，外部嘉宾必填。通过嘉宾链接接入会的嘉宾无此字段。
guest_name
否
String
嘉宾名称，外部嘉宾必填，仅对外部嘉宾生效，内部嘉宾设置不生效（1~16位字符长度）。
email
否
String
邮箱，外部嘉宾选填。通过嘉宾链接接入会的嘉宾无此字段。

输出参数

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

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
400
190001
存在未注册的用户。
500
9003
MEETING NOT EXIST。
500
9042
无权限进行该操作，建议检查操作者身份或资源归属。

示例

输入示例

PUT
https://api.meeting.qq.com/v1/webinars/7687691388848559125/guests
{
    "guests":[
        {
            "phone_number":"15900000001",
            "guest_name":"cat",
            "guest_type":2,
            "area":"86"
        },
        {
            "guest_type":1,
            "userid":"guest1"
        }
    ],
    "instanceid":1,
    "userid":"aaa"
}

输出示例

{}

中国站