腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 投票管理 > 修改会议投票主题

修改会议投票主题

最近更新时间：2024-04-23 16:12:03

我的收藏

本页目录：

修改会议投票主题（多问题）

接口描述

描述：
修改投票主题信息，目前仅支持全覆盖修改。
支持 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"
            ]
        }
    ]
}

修改会议投票主题（单问题）

接口描述

接口描述：当用户为会议主持人时，可在会议下修改一个投票主题。
注意：
多问题投票 API 包含单问题投票的能力。后续单问题投票 API 不再维护，请参见多问题投票 修改会议投票主题（多问题）。
请求方式：PUT
接口请求域名：
https://api.meeting.qq.com/v1/vote-themes/{voteThemeId}

输入参数

以下请求参数列表仅列出了接口请求参数，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
是
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个。

输出参数

无，失败返回错误信息。

代码示例

输入示例

PUT
https://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"
        }
        ]
   }
}

输出示例

无。
中国站