设置联席主持人
接口描述
描述：设置或撤销会议中的参会者联席主持人身份，目前支持 MRA 设备作为被操作者的情况。企业 secret 鉴权用户可管理任何该企业该用户创建的有效会议，OAuth2.0 鉴权用户只能管理通过 OAuth2.0 鉴权创建的有效会议。
调用方式：PUT
接口请求域名：
https://api.meeting.qq.com/v1/real-control/meetings/{meetingId}/cohosts
说明：操作者必须是会议的主持人才可以设置。
调用该接口需要权限项 ： MANAGE_MEETING 查看和管理您的会议。
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
请求路径参数
参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
meetingId | 是 | String | 会议 ID，周期性会议传总会议 ID。 |
请求 body
参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
operator_id | 否 | String | 操作者 ID。 1：operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。 2：接口输入参数如果需要传用户 ID 时，operator_id 和 uuid 不可以同时为空，两个参数如果都传了以 operator_id 为准。 3：如果 operator_id_type=2，operator_id 必须和公共参数的 openid 一致。 |
operator_id_type | 否 | Integer | 操作者 ID 的类型： 2：openid 4：ms_open_id |
uuid | 是 | String | 操作者用户唯一身份 ID，仅支持主持人和联席主持人，且单场会议唯一。 |
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 Mac 22：Rooms for Touch Android 30：Controller for Touch Windows 32：Controller for Touch Android 33：Controller for Touch iOS 说明：使用 ms_open_id 进行调用时，仅支持以上1-9的设备类型。 |
action | 是 | bool | 具体设置动作： true：设置联席主持人 false：撤销联席主持人 |
user | 是 | UserObj | 被操作用户对象信息。 |
被操作用户对象 UserObj
参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
to_operator_id | 否 | String | 被操作者 ID，根据 operator_id_type 的值，使用不同的类型。 |
to_operator_id_type | 否 | Integer | 被操作者 ID 的类型：4. ms_open_id。 |
uuid | 是 | String | 被操作者用户唯一身份 ID，单场会议唯一。 |
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 Mac 22：Rooms for Touch Android 30：Controller for Touch Windows 32：Controller for Touch Android 33：Controller for Touch Iphone 说明：请与被操作者的设备类型保持一致，否则不生效。 |
输出参数
成功返回空消息体，失败返回 错误码 和错误信息。
示例
输入示例
PUT
https://api.meeting.qq.com//v1/real-control/meetings/1242152152161/cohosts
{
"operator_id": "afagsagwags",
"operator_id_type": 4,
"instanceid": 4,
"action":true,
"user":{
"to_operator_id":"agaqwwgdkkddd",
"to_operator_id_type": 4,
"instanceid": 2
}
}