修改会议投票主题(多问题)
接口描述
描述:
修改投票主题信息,目前仅支持全覆盖修改。
支持 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 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。 |
poll_topic | String | 必须 | 投票主题,最多50个字符。 |
poll_desc | String | 非必须 | 投票主题描述,最多100个字符。 |
is_anony | Number | 非必须 | 是否匿名。 0:实名,默认值 1:匿名 |
poll_questions | PollQuestion 对象数组 | 必须 | 投票问题数组,每个投票支持添加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 | PollQuestion 对象数组 | 必须 | 投票问题数组,每个投票支持添加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}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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。 |
vote_theme_info | 是 | VoteTheme 对象 | 投票主题信息。 |
VoteTheme 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
vote_topic | 是 | String | 投票标题,至少1个字符,最多不超过36个字符。 |
vote_desc | 是 | String | 投票描述,最多不超过50个字符。 |
vote_type | 是 | Integer | 投票选择类型: 0:单选 1:多选 |
is_anony | 是 | Integer | 是否匿名: 0:实名 1:匿名 |
vote_opt_list | 是 | VoteOpt 对象数组 | 投票项对象。 |
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"}]}}
输出示例
无。