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

查询会议投票详情

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

我的收藏

本页目录：

查询会议投票详情（多问题）

接口描述

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

输入参数

参数名称
是否必须
是否必须
参数描述
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_id
String
是
投票 ID。

输出参数

参数名称
参数类型
是否必须
参数描述
meeting_id
String
必须
会议 ID。
poll_theme_id
String
必须
投票主题 ID。
poll_id
String
必须
投票 ID。
poll_topic
String
必须
投票主题。
poll_desc
String
必须
投票描述。
is_anony
Integer
必须
是否匿名。
0：实名
1：匿名
status
Integer
必须
投票状态。
0：未开始
1：投票中
2：已结束
is_shared
Integer
必须
是否共享。
vote_total_num
Number
必须
投票人数。
poll_question_data
PollQuestion 对象数组
必须
投票结果数组。

PollQuestion 对象

参数名称
参数类型
是否必须
参数描述
question_desc
String
必须
问题描述。
question_type
Integer
必须
问题类型。
0：单选
1：多选
question_id
String
必须
问题 ID。
option_info
OptionInfo 对象数组
必须
选项信息数组。

OptionInfo 对象

参数名称
参数类型
是否必须
参数描述
option_id
Number
必须
选项 ID。
option_desc
String
必须
选项描述。
option_num
Integer
必须
每个选项的投票数。
rate
Integer
必须
投票比率。
option_user
OptionUser 对象数组
必须
用户信息数组。

OptionUser 对象

参数名称
参数类型
是否必须
参数描述
nick_name
String
必须
用户昵称，如果非匿名，展示。
userid
String
必须
用户 userid，同企业才展示 userid。如果非匿名，展示。
open_id
String
必须
用户 open_id，如果非匿名，展示。
ms_open_id
String
必须
用户 ms_open_id，如果非匿名，展示。

错误码列表

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

代码示例

输入示例

GET https://api.meeting.qq.com/v1/meetings/100001/polls/B7DD75774-C1B7-C841-B69E-7DF550424191?operator_id=testUser1&operator_id_type=1&instanceid=2

输出示例

{
    "meeting_id": "100001",
    "poll_theme_id": "A19124181-C250-5D5C-6AEB-2BE21CA3DD6C",
    "poll_id": "B7DD75774-C1B7-C841-B69E-7DF550424191",
    "poll_topic": "API投票测试主题3",
    "poll_desc": "API投票测试主题描述3",
    "is_anony": 0,
    "status": 1,
    "is_shared": 0,
    "vote_total_num": 0,
    "poll_question_data": [
        {
            "question_id": "Q26405070-A1F3-F165-F34A-9F89057FC99A",
            "question_desc": "问题4",
            "question_type": 0,
            "option_info": [
                {
                    "option_id": 1297247,
                    "option_desc": "选项1",
                    "option_num": 0,
                    "rate": 0
                },
                {
                    "option_id": 1297248,
                    "option_desc": "选项2",
                    "option_num": 0,
                    "rate": 0
                },
                {
                    "option_id": 1297249,
                    "option_desc": "选项3",
                    "option_num": 0,
                    "rate": 0
                }
            ]
        },
        {
            "question_id": "Q08709EC1-FB87-85B6-045A-104F9D62BBCB",
            "question_desc": "问题5",
            "question_type": 0,
            "option_info": [
                {
                    "option_id": 1297250,
                    "option_desc": "1",
                    "option_num": 0,
                    "rate": 0
                },
                {
                    "option_id": 1297251,
                    "option_desc": "2",
                    "option_num": 0,
                    "rate": 0
                },
                {
                    "option_id": 1297252,
                    "option_desc": "3",
                    "option_num": 0,
                    "rate": 0
                }
            ]
        }
    ]
}

查询会议投票详情（单问题）

接口描述

接口描述：当用户为会议主持人时，可获取会议下的正在进行中或已结束的一个投票的投票结果。
注意：
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护，请参见多问题投票 查询会议投票详情（多问题）。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/votes/{voteId}

输入参数

以下请求参数列表仅列出了接口请求参数，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_topic
String
投票主题。
vote_desc
String
投票描述。
vote_theme_id
String
投票未正式发起前的投票 ID，以“A”开头的一串字符串。
vote_id
String
投票已正式发起后的投票 ID，以“B”开头的一串字符串。
vote_type
Integer
投票选择类型：
0：单选
1：多选
is_anony
Integer
是否匿名：
0：实名
1：匿名
meeting_id
String
会议 ID
userid
String
用户的 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。
status
Integer
投票状态：
1：正在进行中
2：已结束
vote_total_num
Integer
投票总票数。
vote_opt_list
VoteOpt 对象数组
投票选项详情列表。

VoteOpt 对象

参数名称
参数类型
参数描述
opt_id
String
投票 ID。
opt_desc
String
投票描述。
opt_number
Integer
选择此项的数量。
opt_user_list
OptUser 对象数组
选择此项的用户列表，最多支持100个用户。

OptUser 对象

参数名称
参数类型
参数描述
userid
String
投票用户的 ID（返回同企业内的 userid，企业外的用户返回为空）。
nick_name
String
用户昵称。

代码示例

输入示例

GET https://api.meeting.qq.com/v1/votes/BA2F117B3-F7D6-7276-4E7D-E3680B03685D?userid=tester&instanceid=10&meeting_code=86359399865

输出示例

{
  "vote_topic": "API测试修改投票主题",
  "vote_desc": "测试",
  "vote_theme_id": "AB45E1FD8-6EE4-GA65-21HY-AB9DBFE92BFG",
  "vote_id": "BA2F117B3-F7D6-7276-4E7D-E3680B03685D",
  "vote_type": 0,
  "is_anony": 0,
  "meeting_id": "4086006821859918718",
  "userid": "haynesxiang",
  "status": 2,
  "vote_total_num": 1,
  "vote_opt_list": [{
      "opt_id": "20435",
      "opt_desc": "99",
      "opt_number": 0
  }, {
      "opt_id": "20436",
      "opt_desc": "999",
      "opt_number": 0
  }, {
      "opt_id": "20437",
      "opt_desc": "9999",
      "opt_number": 1,
      "opt_user_list": [{
          "userid": "john117",
          "nick_name": "xxxx"
      }]
  }]
}


中国站