腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 投票管理 > 删除会议投票

删除会议投票

最近更新时间：2024-04-23 16:12:03

我的收藏

本页目录：

删除会议投票（多问题）

接口描述

描述：
删除会议投票。
支持 OAuth 鉴权，权限：管理投票信息。
请求方式：DELETE
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{meetingId}/polls

输入参数

参数名称
参数类型
是否必须
参数描述
operator_id
String
必须
操作者 ID。
会议的创建者、主持人、联席主持人，才可以删除投票。
operator_id_type
Integer
必须
操作者 ID 的类型：
1：企业内用户 userid
2：open_id
4：ms_open_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 MacOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS
poll_theme_id
String
否
投票主题 ID，传入则代表删除投票主题，删除投票主题不影响投票实例。投票主题 ID 和投票 ID 二选一，如果都传入，会使用投票 ID。
poll_id
String
否
投票 ID，传入则代表删除投票实例。当主题下所有主题实例被删，则投票主题也被删除。投票主题 ID 和投票 ID 二选一，如果都传入，会使用投票 ID。

输出参数

成功则返回空值。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
500
310001
会议与投票不匹配。
500
300102
投票已被删除。
500
190001
存在未注册的用户。
500
20009
未查找到相应的会议信息，请检查会议是否存在。
500
9042
无权限进行该操作，建议检查操作者身份或资源归属。

代码示例

输入示例

DELETE https://api.meeting.qq.com/v1/meetings/100001/polls
{
    "operator_id":"testUser1",
    "operator_id_type":"1",
    "instanceid":2,
    "poll_theme_id":"A32597387-5AB9-97CE-FD4E-07FC79DDCBD1",
    "poll_id":"BF06B4E48-B3AE-97DC-3B92-8B522ABAD5ED"
}

输出示例

{}

删除会议投票主题（单问题）

接口描述

描述：当用户为会议主持人时，可删除会议下的投票主题。
注意：
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护，请参见多问题投票 删除会议投票（多问题）。
请求方式：DELETE
接口请求域名：
https://api.meeting.qq.com/v1/vote-themes/{voteThemeId}?userid={userid}&instanceid={instanceid}&meeting_code={meeting_code}&meeting_id={meeting_id}

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
userid
是
String
用户的 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。
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
meeting_id
否
String
会议 ID。
meeting_code
否
String
会议 Code。
注意：
meeting_code 和 meeting_id 参数不能同时为空，至少传入一个。

输出参数

成功无返回信息，失败返回错误信息。

代码示例

输入示例

DELETE
https://api.meeting.qq.com/v1/vote-themes/A064A36EB-A86F-64EB-2D15-5B7887EF5ABA?userid=tester&instanceid=1&meeting_code=83359349765

输出示例

无。

删除投票（单问题）

接口描述

描述：当用户为会议主持人时，可删除会议下的投票。
注意：
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护，请参见多问题投票 删除会议投票（多问题）。
请求方式：DELETE
接口请求域名：
https://api.meeting.qq.com/v1/votes/{voteId}?userid={userid}&instanceid={instanceid}&meeting_code={meeting_code}&meeting_id={meeting_id}

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
userid
是
String
用户的 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。
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
meeting_id
否
String
会议 ID。
meeting_code
否
String
会议 Code。
注意：
meeting_code 和 meeting_id 参数不能同时为空，至少传入一个。

输出参数

成功无返回信息，失败返回错误信息。

代码示例

输入示例

DELETE
https://api.meeting.qq.com/v1/votes/B064A36EB-A86F-64EB-2D15-5B7887EF5ABA?userid=tester&instanceid=1&meeting_code=83359349765

输出示例

无。
中国站