接口描述
描述:修改指定的网络研讨会嘉宾列表,只有网络研讨会的创建者才有权限修改。
请求方式:PUT
接口请求域名:
https://api.meeting.qq.com/v1/webinars/{meeting_id}/guests
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
示例
输入示例
PUThttps://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"}
输出示例
{}