修改会议投票主题(多问题)
接口描述
描述:
修改投票主题信息,目前仅支持全覆盖修改。
支持 OAuth 鉴权,权限:管理投票信息。
请求方式:PUT
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/polls
输入参数
| 参数名称	       | 必填 | 参数类型       | 参数描述    | 
| 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 12:Vision Pro 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 81:HarmonyOS Phone 82:HarmonyOS Tablet 83:HarmonyOS PC 84:HarmonyOS Intelligent Cockpit 86:HarmonyOS AR/VR | 
| poll_theme_id	 | 是 | String	 | 投票主题 ID。   	 | 
| poll_topic	 | 是 | String	 | 投票主题,最多50个字符。   	 | 
| poll_desc	 | 否 | String	 | 投票主题描述,最多100个字符。  	 | 
| is_anony		 | 否 | Number	 | 是否匿名。 0:实名,默认值  1:匿名		 | 
| poll_questions	 | 是 | 投票问题数组,每个投票支持添加10个问题。 	 | 
PollQuestion 对象
| 参数名称	       | 必填 | 参数类型       | 参数描述    | 
| question_desc	 | 是 | String	 | 问题描述,最多50个字符。     | 
| question_type	 | 是 | Number	 | 问题选择类型。 0:单选  1:多选     | 
| poll_option	 | 是 | String 数组	 | 每个问题支持添加10个选项,最少为2个选项。每个选项最多支持36个字符。 | 
输出参数
| 参数名称	       | 参数类型       | 参数描述    | 
| meeting_id	 | String	 | 会议 ID。    	 | 
| poll_theme_id | String	 | 投票模板 ID。    | 
| poll_topic	 | String	 | 投票主题,最多50个字符。    | 
| poll_desc | String	 | 投票主题描述,最多100个字符。    | 
| is_anony | Number	 | 是否匿名。  0:实名,默认值  1:匿名	 | 
| poll_questions	 | 投票问题数组,每个投票支持添加10个问题。     | 
PollQuestion 对象
| 参数名称	       | 参数类型       | 参数描述    | 
| question_desc | String | 问题描述,最多50个字符。   | 
| question_type | Number | 问题选择类型。 0:单选  1:多选   | 
| poll_option | String 数组 | 选项内容。 | 
错误码列表
| 状态码 | 错误码 | 错误描述 | 
| 400 | 190004 | 参数非法,请对照接口文档检查您的参数。 | 
| 500 | 300107 | 该投票已发起。 | 
| 500 | 20009 | 未查找到相应的会议信息,请检查会议是否存在。 | 
| 500 | 190001 | 存在未注册的用户。 | 
| 500 | 300402 | 查询用户信息与会议不匹配。 | 
| 500 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 | 
| 500 | 310001 | 会议与投票不匹配。 | 
代码示例
输入示例
PUT https://api.meeting.qq.com/v1/meetings/100001/polls{"operator_id":"testUser1","operator_id_type":"1","instanceid":2,"poll_theme_id":"A19124181-C250-5D5C-6AEB-2BE21CA3DD6C","poll_topic":"API投票测试主题3","poll_desc":"API投票测试主题描述3","is_anony":0,"poll_questions":[{"question_desc":"问题4","question_type":0,"poll_option":["选项1","选项2","选项3"]},{"question_desc":"问题5","question_type":0,"poll_option":["1","2","3"]}]}
输出示例
{"meeting_id": "100001","poll_theme_id": "A19124181-C250-5D5C-6AEB-2BE21CA3DD6C","poll_topic": "API投票测试主题3","poll_desc": "API投票测试主题描述3","is_anony": 0,"poll_questions": [{"question_desc": "问题4","question_type": 0,"poll_option": ["选项1","选项2","选项3"]},{"question_desc": "问题5","question_type": 0,"poll_option": ["1","2","3"]}]}
修改会议投票主题(单问题)
接口描述
接口描述:当用户为会议主持人时,可在会议下修改一个投票主题。
注意:
请求方式:PUT
接口请求域名:
https://api.meeting.qq.com/v1/vote-themes/{voteThemeId}
输入参数
路径参数
| 参数名称 | 必填 | 参数类型 | 参数描述 | 
| voteThemeId | 是 | String | 投票主题 id。 | 
请求体
| 参数名称 | 必填 | 参数类型 | 参数描述 | 
| userid | 是 | String | 用户的 ID(企业内部请使用企业唯一用户标识;OAuth 2.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 12:Vision Pro 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 81:HarmonyOS Phone 82:HarmonyOS Tablet 83:HarmonyOS PC 84:HarmonyOS Intelligent Cockpit 86:HarmonyOS AR/VR | 
| meeting_id | 否 | String | 会议 ID。 | 
| meeting_code | 否 | String | 会议 Code。 | 
| vote_theme_info | 是 | 投票主题信息。 | 
VoteTheme 对象
| 参数名称 | 必填 | 参数类型 | 参数描述 | 
| vote_topic | 是 | String | 投票标题,至少1个字符,最多不超过36个字符。 | 
| vote_desc | 是 | String | 投票描述,最多不超过50个字符。 | 
| vote_type | 是 | Integer | 投票选择类型: 0:单选 1:多选 | 
| is_anony | 是 | Integer | 是否匿名: 0:实名 1:匿名 | 
| vote_opt_list | 是 | 投票项对象。 | 
VoteOpt 对象
| 参数名称 | 必填 | 参数类型 | 参数描述 | 
| opt_desc | 是 | String | 投票选项描述,至少1个字符,最多不超过36个字符。 | 
注意:
1. meeting_code 和 meeting_id 参数不能同时为空,至少传入一个。
2. 投票选项至少2个,最多不超过10个。
输出参数
无,失败返回错误信息。
代码示例
输入示例
PUThttps://api.meeting.qq.com/v1/vote-themes/A7A99DA76-4794-E0C8-BF58-ED851A20B735{"userid": "tester","instanceid": 1,"meeting_id": "4086006821859918718","vote_theme_info": {"vote_topic": "API测试修改投票主题","vote_desc": "API","vote_type": 0,"is_anony": 0,"vote_opt_list": [{"opt_desc": "选项1"},{"opt_desc": "选项2"}]}}
输出示例
无。