腾讯会议
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 投票管理 > 查询会议投票主题信息

查询会议投票主题信息

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

我的收藏

本页目录：

查询会议投票主题信息（多问题）

接口描述

描述：
查投票模板的详细信息，包括问题、选项，但不包括投票结果。
支持 OAuth 鉴权，权限：查询投票信息或管理投票信息。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{meetingId}/polls

输入参数

参数名称
参数类型
是否必须
参数描述
operator_id
String
是
操作者 ID。
会议的创建者、主持人、联席主持人，才可以查询投票。
operator_id_type
Integer
是
操作者 ID 的类型：
1：企业内用户 userid
2: open_id4: 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。

输出参数

参数名称
参数类型
是否必须
参数描述
meeting_id
String
必须
会议 ID。
poll_theme_id
String
必须
投票主题 ID。
poll_topic
String
必须
投票主题。
poll_desc
String
必须
投票描述。
is_anony
Integer
必须
是否匿名。
0：实名
1：匿名
poll_question_data
PollQuestion 对象数组
必须
投票问题数组。

PollQuestion 对象

参数名称
参数类型
是否必须
参数描述
question_desc
String
必须
问题描述，最多50个字符。
question_type
Integer
必须
问题选择类型。
0：单选
1：多选
option_info
OptionInfo 对象
必须
选项信息数组。

OptionInfo 对象

参数名称
参数类型
是否必须
参数描述
option_id
Number
必须
选项 ID。
option_desc
String
必须
选项描述。

错误码列表

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

示例

输入示例

GET https://api.meeting.qq.com/v1/meetings/100001/polls?operator_id=testUser&operator_id_type=1&instanceid=2&poll_theme_id=A19124181-C250-5D5C-6AEB-2BE21CA3DD6C

输出示例

{
    "meeting_id": "100001",
    "poll_theme_id": "A19124181-C250-5D5C-6AEB-2BE21CA3DD6C",
    "poll_topic": "API投票测试主题3",
    "poll_desc": "API投票测试主题描述3",
    "is_anony": 0,
    "poll_question_data": [
        {
            "question_desc": "问题4",
            "question_type": 0,
            "option_info": [
                {
                    "option_desc": "选项1"
                },
                {
                    "option_desc": "选项2"
                },
                {
                    "option_desc": "选项3"
                }
            ]
        },
        {
            "question_desc": "问题5",
            "question_type": 0,
            "option_info": [
                {
                    "option_desc": "1"
                },
                {
                    "option_desc": "2"
                },
                {
                    "option_desc": "3"
                }
            ]
        }
    ]
}

查询会议投票主题信息（单问题）

接口描述

描述：当用户为会议主持人时，可获取会议下的投票主题列表。
注意：
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护，请参见多问题投票 查询会议投票主题信息（多问题）。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/vote-themes

输入参数

以下请求参数列表仅列出了接口请求参数，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 参数不能同时为空，至少传入一个。

输出参数

参数名称
参数类型
参数描述
vote_themes_number
Integer
投票主题数量。
vote_theme_list
VoteTheme 对象数组
投票主题列表。

VoteTheme 对象

参数名称
参数类型
参数描述
vote_topic
String
投票标题。
vote_desc
String
投票描述。
vote_theme_id
String
投票未正式发起前的投票 ID，以“A”开头的一串字符串。
vote_type
Integer
投票选择类型：
0：单选
1：多选
is_anony
Integer
是否匿名：
0：实名
1：匿名
meeting_id
String
会议 ID。
userid
String
投票主题创建人用户的 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。
vote_opt_list
VoteOp t对象数组
投票选项对象列表。

VoteOpt 对象

参数名称
参数类型
参数描述
opt_id
String
投票选项 ID。
opt_desc
String
投票选项描述。

代码示例

输入示例

GET https://api.meeting.qq.com/v1/vote-themes?userid=tester&instanceid=1&meeting_code=86359399865

输出示例

{
  "vote_themes_number": 2,
  "vote_theme_list": [{
      "vote_topic": "测试创建投票主题",
      "vote_desc": "API",
      "vote_theme_id": "A5B17E823-865C-A655-8DFE-FFB12629C2A6",
      "vote_type": 0,
      "is_anony": 0,
      "meeting_id": "4086006821859918718",
      "userid": "tester",
      "vote_opt_list": [{
          "opt_id": "375246",
          "opt_desc": "乘"
      }, {
          "opt_id": "375247",
          "opt_desc": "除"
      }]
  }, {
      "vote_topic": "API测试修改投票主题",
      "vote_desc": "测试",
      "vote_theme_id": "A7A99DA76-4794-E0C8-BF58-ED851A20B735",
      "vote_type": 0,
      "is_anony": 0,
      "meeting_id": "4086006821859918718",
      "userid": "tester",
      "vote_opt_list": [{
          "opt_id": "375248",
          "opt_desc": "99"
      }, {
          "opt_id": "375249",
          "opt_desc": "999"
      }, {
          "opt_id": "375250",
          "opt_desc": "9999"
      }]
  }]
}

中国站