腾讯会议移出用户_办公协同解决方案
接口描述
描述:将会议中用户移出会议,操作者必须是会议的创建者、主持人或者联席主持人才可以设置。支持对云会议已入会成员和 Webinar 观众移出。支持 MRA 设备和 PSTN 设备为被操作者时的移出用户操作。企业 secret 鉴权用户可管理任何该企业该用户创建的有效会议,OAuth2.0 鉴权用户只能管理通过 OAuth2.0 鉴权创建的有效会议。说明1:操作者必须是会议的创建者、主持人或者联席主持人才可以设置。2:调用该接口需要权限项:MANAGE_MEETING 查看和管理您的会议。请求方式:PUT接口请求域名:
https://api.meeting.qq.com/v1/real-control/meetings/{meetingId}/kickout
输入参数
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 的类型:1:userid2:openid 4:ms_open_id 详见 关键 ID 说明。 |
uuid | 否 | String | 操作者用户唯一身份 ID,仅支持主持人和联席主持人,且只适用于单场会议。即将废弃,推荐使用 operator_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 |
allow_rejoin | 是 | bool | 移出后是否允许再次入会:true:允许再次入会false:不允许 |
reason | 否 | String | 移出原因说明。当用户设备为 MRA 时,该参数必须填写移出原因。 |
users | 是 | User 对象数组 | 被操作用户对象信息列表。 |
User 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
to_operator_id | 否 | String | 被操作者 ID,根据 to_operator_id_type 的值,使用不同的类型。 |
to_operator_id_type | 否 | Integer | 被操作者 ID 的类型:4:ms_open_id 详见 关键 ID 说明。 |
uuid | 否 | String | 被操作者用户唯一身份 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说明:请与被操作者的设备类型保持一致,否则不生效。 |
输出参数
成功返回空消息体,失败返回 错误码 和错误信息。
示例
输入示例
PUThttps://api.meeting.qq.com//v1/real-control/meetings/1242152152161/kickout
{ "uuid": "afagsagwags", "instanceid": 4, "allow_rejoin":false, "reason":"test", "users":[{ "uuid":"agaqwwgdkkddd", "instanceid":2 }, { "uuid":"agaqwwgdkksd", "instanceid":5 } ]}
对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案