一、接口描述
·描述:关闭会议中用户屏幕共享权限,目前暂不支持 MRA 设备作为被操作者的情况。企业 secret 鉴权用户可管理任何该企业用户创建的有效会议,OAuth 2.0鉴权用户只能管理通过 OAuth 2.0鉴权创建的有效会议。
注意:说明:
注意:1:操作者必须是会议的创建者、主持人或者联席主持人才可以设置。
注意:2:调用该接口需要权限项:MANAGE_MEETING 查看和管理你的会议。
·请求方式:PUT
·接口请求域名:
二、输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
三、请求路径参数
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| meetingId | 是 | String | 会议 ID,周期性会议传总会议 ID。 |
四、请求 body
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| operator_id | 否 | String | 操作者 ID。1:operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。2:如果 operator_id_type=2,operator_id 必须和公共参数的 openid 一致。 |
| operator_id_type | 否 | Integer | 操作者 ID 的类型:1:userid2:openid4:ms_open_id |
| instanceid | 是 | Integer | 用户的终端设备类型:0:PSTN1:PC2:Mac3:Android4:iOS5:Web6:iPad7:Android Pad8:小程序9:voip、sip 设备10:Linux20:Rooms for Touch Windows21:Rooms for Touch MacOS22:Rooms for Touch Android30:Controller for Touch Windows32:Controller for Touch Android33:Controller for Touch iOS |
| user | 是 | User 对象 | 被操作用户对象信息。 |
五、User 对象
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| to_operator_id | 否 | String | 被操作者 ID,根据 to_operator_id_type 的值,使用不同的类型。 |
| to_operator_id_type | 否 | Integer | 被操作者 ID 的类型:4:ms_open_id |
| instanceid | 是 | Integer | 用户的终端设备类型:0:PSTN1:PC2:Mac3:Android4:iOS5:Web6:iPad7:Android Pad8:小程序9:voip、sip 设备10:Linux20:Rooms for Touch Windows21:Rooms for Touch MacOS22:Rooms for Touch Android30:Controller for Touch Windows32:Controller for Touch Android33:Controller for Touch iOS说明:请与被操作者的设备类型保持一致,否则不生效。 |
六、输出参数
成功返回空消息体,失败返回 错误码 和错误信息。
七、错误码列表
| 状态码 | 错误码 | 错误描述 |
| 400 | 190004 | 参数非法,请对照接口文档检查你的参数。 |
| 400 | 190455 | 非会议中不允许操作。 |
| 400 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
| 500 | 190456 | 查询用户不存在,请检查该用户是否注册。 |
| 500 | 190001 | 存在未注册的用户。 |
八、输入示例
PUThttps://api.meeting.qq.com//v1/real-control/meetings/1242152152161/screen-shared{ "instanceid": 4, "user":{ "instanceid":2 }}