有奖捉虫:云通信与企业服务文档专题,速来> HOT

查询会议投票列表(多问题)

接口描述

描述:
查询指定会议的投票列表。
支持 OAuth 鉴权,权限:查询投票信息或管理投票信息。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/polls-list

输入参数

参数名称
参数类型
是否必须
参数描述
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

输出参数

参数名称
参数类型
是否必须
参数描述
polls_theme_info
PollsTheme 对象数组
必须
投票主题信息列表。

PollsTheme 对象

参数名称
参数类型
是否必须
参数描述
poll_theme_id
String
必须
投票主题 ID。
polls_info
PollsInfo 对象数组
必须
投票信息列表。

PollsInfo 对象

参数名称
参数类型
是否必须
参数描述
poll_id
String
必须
投票 ID。
poll_topic
String
必须
投票标题。
status
Integer
必须
投票状态。
0:未开始
1:投票中
2:已结束
is_shared
Integer
必须
共享状态。
0:未共享
1:已共享
is_anony
Integer
必须
是否匿名。
0:实名
1:匿名

代码示例

输入示例

GET https://api.meeting.qq.com/v1/meetings/100001/polls-list?operator_id=testUser&operator_id_type=1&instanceid=2

输出示例

{
"polls_theme_info": [
{
"poll_theme_id": "A19124181-C250-5D5C-6AEB-2BE21CA3DD6C",
"polls_info": [
{
"poll_id": "B7DD75774-C1B7-C841-B69E-7DF550424191",
"poll_topic": "API投票测试主题3",
"status": 1,
"is_shared": 0,
"is_anony": 0
}
]
}
]
}

查询会议投票列表(单问题)

接口描述

接口描述:当用户为会议主持人时,可获取会议下的正在进行中和已结束的投票列表。
注意:
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护,请参见多问题投票 查询会议投票列表(多问题)
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/votes

输入参数

以下请求参数列表仅列出了接口请求参数,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。
page
Integer
当前页,从1开始。
page_size
Integer
当前页大小,最小值为1,最大值为20。
注意:
meeting_code 和 meeting_id 参数不能同时为空,至少传入一个。

输出参数

参数名称
参数类型
参数描述
vote_total_number
Integer
投票数量。
vote_total_page
Integer
投票结果总页数。
vote_current_page
Integer
当前页。
vote_current_size
Integer
当前页大小。
vote_list
Vote 对象数组
投票主题列表。

Vote 对象

参数名称
参数类型
参数描述
vote_topic
String
投票标题,至少1个字符,最多不超过36个字符。
vote_theme_id
String
投票未正式发起前的投票 ID,以“A”开头的一串字符串。
vote_id
String
投票已正式发起后的投票 ID,以“B”开头的一串字符串。
status
Integer
投票状态:
1:正在进行中
2:已结束

代码示例

输入示例

GET https://api.meeting.qq.com/v1/votes?userid=tester&instanceid=1&meeting_code=86359399865&page=1&page_size=20

输出示例

{
"vote_total_number": 1,
"vote_total_page": 1,
"vote_current_page": 1,
"vote_current_size": 1,
"vote_list": [{
"vote_topic": "API测试",
"vote_theme_id": "AB45E1FD8-6EE4-GA65-21HY-AB9DBFE92BFG",
"vote_id": "BC44E1FD9-6EF4-DA95-29FA-AF9DBEE88FFA",
"status": 2
}]
}