获取会议投票

GET

/accounts/{accountId}/meetings/{meetingId}/polls/{pollId}

投票允许会议主持人调查与会者。检索有关特定会议的信息投票。

** 范围: ** 'meeting:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api-reference/Rate-limits # 速率限制):** 'Light'

请求参数

Path 参数

meetingId

integer

必需

会议的ID。

在数据库中存储此值时，必须将其存储为长格式整数，而不是整数。会议id可以超过10位数。

pollId

string

投票ID

必需

accountId

string

帐户的唯一标识符。

必需

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200** HTTP状态代码: ** '200' 返回会议投票对象

application/json

Body

有关会议和网络研讨会投票的信息。

questions

array [object {14}]

可选

有关民意调查问题的信息。

answer_required

boolean

可选

参与者是否必须回答以下问题:

“真”-参与者必须回答问题。

“假”-参与者不需要回答问题。

** 注: **

当轮询的 'type' 值为 '1' (轮询) 时，此值默认为 'true'。

当投票的 “类型” 值为 “2” (高级投票) 或 “3” (测验) 值时，此值默认为 “false”。

默认值:

false

示例值:

false

answer_min_character

integer

可选

允许的最小字符数。此字段仅适用于 'short_answer' 和 'long_answer' 投票。您必须至少提供 ** 一个 ** 字符最小值。

>= 1

示例值:

rating_min_value

integer

可选

等级量表的最小值。此值不能小于零。

此字段仅适用于 “rating_scale” 轮询。

>= 0

示例值:

answers

array[string]

可选

民意调查问题的可用答案。此字段需要 ** 至少 ** 两个答案。

对于 “单个” 和 “多个” 投票，您最多只能提供10个答案。

对于 “匹配” 民意调查，您最多只能提供16个答案。

对于 “rank_order” 投票，您最多只能提供七个答案。

>= 2 items

type

enum<string>

可选

民意调查的问题和答案类型:

'single'-单选。

“多”-多项选择。

'匹配'-匹配。

'rank_order'-等级顺序。

'short_answer'-简短的回答。

'long_answer'-长答案。

'fill_in_the_blank'-填写空白。

“rating_scale”-评级量表。

枚举值:

singlemultiplematchingrank_ordershort_answerlong_answerfill_in_the_blankrating_scale

示例值:

single

answer_max_character

integer

可选

允许的最大字符数。此字段仅适用于 'short_answer' 和 'long_answer' 投票:

对于 “short_answer” 轮询，最多500个字符。

对于 'long_answer' 投票，最多2，000个字符。

示例值:

200

rating_max_value

integer

可选

等级量表的最大值，最大值为10。

此字段仅适用于 “rating_scale” 轮询。

<= 10

示例值:

right_answers

array[string]

可选

投票问题的正确答案。如果投票的 “类型” 值为 “3” (测验)，则此字段为 ** 必填 **。

对于 “单一” 和 “匹配” 投票，此字段只接受一个答案。

>= 1 items

show_as_dropdown

boolean

可选

是否将单选选项显示为下拉框:

“真”-显示为一个下拉框。

'false'-不显示为下拉框。

此值默认为 “false”。

默认值:

false

示例值:

false

rating_min_label

string

可选

用于 'rating_min_value' 字段的低分标签。

此字段仅适用于 “rating_scale” 轮询。

示例值:

Not likely

case_sensitive

boolean

可选

正确答案是否区分大小写。此字段仅适用于 'fill_in_the_blank' 轮询:

'true'-答案是区分大小写的。

'false'-答案不区分大小写。

此值默认为 “false”。

默认值:

false

示例值:

false

name

string

可选

投票问题，最多255个字符。

对于 'fill_in_the_blank' 投票，此字段是投票的问题。对于用户必须填写的每个值，请确保有相同数量的 “right_answers” 值。

<= 255 字符

示例值:

How useful was this meeting?

rating_max_label

string

可选

用于 “rating_max_value” 字段的高分标签。

此字段仅适用于 “rating_scale” 轮询。

示例值:

Extremely Likely

prompts

array [object {2}]

可选

有关提示问题的信息。此字段仅适用于 “matching” 和 “rank_order” 轮询。您 ** 必须 ** 提供最少两个提示，最多10个提示。

anonymous

boolean

可选

允许会议参与者匿名回答投票问题。

此值默认为 “false”。

默认值:

false

示例值:

true

poll_type

enum<integer>

可选

投票的类型:

'1'-投票。

'2'-高级投票。必须在您的Zoom帐户中启用此功能。

'3'-测验。必须在您的Zoom帐户中启用此功能。

此值默认为 “1”。

枚举值:

123

示例值:

string

会议投票ID

可选

示例值:

QalIoKWLTJehBJ8e1xRrbQ

title

string

可选

投票的标题，最多64个字符。

<= 64 字符

示例值:

Learn something new

status

enum<string>

可选

会议投票的状态:
'notstart'-轮询未开始
'started'-投票开始
“已结束”-投票已结束
“共享”-共享民意调查结果

枚举值:

notstartstartedendedsharing

示例值:

notstart

示例

{
    "questions": [
        {
            "answer_required": false,
            "answer_min_character": 1,
            "rating_min_value": 0,
            "answers": [
                "Extremely useful",
                "Extremely useful"
            ],
            "type": "single",
            "answer_max_character": 200,
            "rating_max_value": 4,
            "right_answers": [
                "Good"
            ],
            "show_as_dropdown": false,
            "rating_min_label": "Not likely",
            "case_sensitive": false,
            "name": "How useful was this meeting?",
            "rating_max_label": "Extremely Likely",
            "prompts": [
                {
                    "prompt_question": "How are you?",
                    "prompt_right_answers": [
                        "Good"
                    ]
                }
            ]
        }
    ],
    "anonymous": false,
    "poll_type": 1,
    "id": "QalIoKWLTJehBJ8e1xRrbQ",
    "title": "Learn something new",
    "status": "notstart"
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '4400' 会议投票已禁用。要启用此功能，请在Zoom web门户的 “设置” 界面中启用 “会议投票/测验” 设置。 ** 错误代码: ** '3161' 您的用户帐户不允许使用会议托管和日程安排功能。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '404' 找不到会议投票。

修改于 2023-10-31 06:13:33

说明

删除会议投票