查询会议投票主题信息(多问题)
接口描述
描述:
查投票模板的详细信息,包括问题、选项,但不包括投票结果。
支持 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"}]}]}
查询会议投票主题信息(单问题)
接口描述
描述:当用户为会议主持人时,可获取会议下的投票主题列表。
注意:
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/vote-themes
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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"}]}]}