腾讯会议结束会议_办公协同解决方案
接口描述
描述:结束一个进行中的会议。只有会议创建者、主持人、联席主持人可以结束会议,且该会议是一个有效的进行中会议。结束周期性会议需要传入主会议 ID。企业 secret 鉴权用户可结束任何该企业用户创建的进行中的会议,OAuth 2.0鉴权用户只能结束通过 OAuth 2.0鉴权创建的进行中的会议。当您想实时监测会议结束状况时,您可以通过订阅 会议结束 的事件,接收事件通知。此接口暂不支持 MRA 设备作为被操作者的情况。结束会议不会释放 Rooms,如需释放请调用 释放会议室(Rooms)接口。请求方式:POST接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/dismiss
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称 | 必选 | 参数类型 | 参数描述 |
meetingId | 是 | String | 会议的唯一 ID。 |
operator_id | 否 | String | 操作者 ID,根据 operator_id_type 的值,使用不同的类型。 |
operator_id_type | 否 | Integer | 操作者 ID 的类型:1:userid2:openid4:ms_open_id |
userid | 否 | String | 调用方用于标示用户的唯一 ID(企业内部请使用企业唯一用户标识;OAuth 2.0鉴权用户请使用 openId)。企业唯一用户标识说明:企业对接 SSO 时使用的员工唯一标识 ID,企业调用创建用户接口时传递的 userid 参数。 |
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 |
reason_code | 是 | Integer | 原因代码,可为用户自定义。 |
reason_detail | 否 | String | 详细取消原因描述。 |
force_dismiss_meeting | 否 | Integer | 是否强制结束会议,默认值为1:0:不强制结束会议,会议中有参会者,则无法强制结束会议1 :强制结束会议,会议中有参会者,也会强制结束会议 |
retrieve_code | 否 | Integer | 是否回收会议号,默认值为0:0:不回收会议号,可以重新入会1: 回收会议号,不可重新入会说明:周期性会议如果还有子会议,需设置为不回收会议号,否则会导致后续子会议无法正常进行。此字段对快速会议不生效,快速会议会强制收回会议号。 |
输出参数
无输出参数,成功返回空消息体,失败返回 错误码 和错误信息。
示例
输入示例
POST https://api.meeting.qq.com/v1/meetings/7567173273889276131/dismiss{ "userid" : "test1", "instanceid" : 1, "reason_code" : 3, "reason_detail" : "结束会议", "retrieve_code":1, "force_dismiss_meeting":1}
输出示例
取消成功,返回 Body 为空。
对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案