腾讯会议查询会议投票详情_办公协同解决方案

查询会议投票详情(多问题)

接口描述

接口描述:查投票的详情,包括问题、选项、投票结果。支持 OAuth 鉴权,权限:查询投票信息或管理投票信息。请求方式:GET接口请求域名:

https://api.meeting.qq.com/v1/meetings/{meetingId}/polls/{poll_id}

输入参数

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

代码示例

输入示例

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: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
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"      }]  }]}



对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案