有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

创建会议投票主题(多问题)

接口描述

描述:
为指定的会议创建投票。该接口投票支持多问题。
支持 OAuth 鉴权,权限:管理投票信息。
请求方式:POST
接口请求域名:
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:Android4: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_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
190311
投票主题数量超过上限。
400
190004
参数非法,请对照接口文档检查您的参数。
500
20009
未查找到相应的会议信息,请检查会议是否存在。
500
190001
存在未注册的用户。
500
300402
查询用户信息与会议不匹配。
500
9042
无权限进行该操作,建议检查操作者身份或资源归属。
500
300000
保存失败,请检查输入内容后重试。
500
20011
无效的 ms_open_id。
500
310005
会议状态异常。

代码示例

输入示例

POST https://api.meeting.qq.com/v1/meetings/100001/polls
{
"operator_id":"testUser1",
"operator_id_type":"1",
"instanceid":2,
"poll_topic":"API投票测试主题1",
"poll_desc":"API投票测试主题描述1",
"is_anony":0,
"poll_questions":[
{"question_desc":"问题1","question_type":0,"poll_option":["选项1","选项2","选项3"]},
{"question_desc":"问题2","question_type":0,"poll_option":["1","2","3"]}]
}

输出示例

{
"meeting_id": "100001",
"poll_theme_id": "A19123456-C250-5D5C-6AEB-2BE21CA3DD6C",
"poll_topic": "API投票测试主题1",
"poll_desc": "API投票测试主题描述1",
"is_anony": 0,
"poll_questions": [
{
"question_desc": "问题1",
"question_type": 0,
"poll_option": [
"选项1",
"选项2",
"选项3"
]
},
{
"question_desc": "问题2",
"question_type": 0,
"poll_option": [
"1",
"2",
"3"
]
}
]
}

创建会议投票主题(单问题)

接口描述

描述:当用户为会议主持人时,可在会议下创建一个投票主题。
注意:
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护,请参见多问题投票 创建会议投票主题(多问题)
请求方式:POST
接口请求域名
https://api.meeting.qq.com/v1/vote-themes

输入参数

以下请求参数列表仅列出了接口请求参数,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。
vote_theme_info
VoteThemeInfo 对象
投票主题信息。

VoteThemeInfo 对象

参数名称
必选
参数类型
参数描述
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个。
3. 一个会议最多发起20个投票主题。

输出参数

参数名称
参数类型
参数描述
vote_theme_id
String
投票未正式发起前的投票 ID,以“A”开头的一串字符串。

代码示例

输入示例

POST
https://api.meeting.qq.com/v1/vote-themes
{
"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"
}
]
}
}

输出示例

{"vote_theme_id":"A7A99DA76-4794-E0C8-BF58-ED851A20B735"}