查询会议投票详情(多问题)
接口描述
接口描述:查投票的详情,包括问题、选项、投票结果。支持 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折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案