更新网络研讨会调查

PATCH

/accounts/{accountId}/webinars/{webinarId}/survey

Webinars

更新网络研讨会调查。** 先决条件: ** * 具有网络研讨会附加组件的Pro或更高版本计划。*在主持人的帐户中启用 ** 网络研讨会调查 ** 功能。

** 范围: ** 'webinar:master'

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

请求参数

Path 参数

webinarId

integer

网络研讨会的ID。

必需

accountId

string

帐户的唯一标识符。

必需

Body 参数application/json

有关网络研讨会调查的信息。

show_in_the_browser

boolean

可选

是否启用 ** 网络研讨会结束时在浏览器中显示 ** 选项。

'true'-已启用。

'false'-已禁用。

此值默认为 “true”。

默认值:

true

示例值:

true

custom_survey

object

可选

有关定制网络研讨会调查的信息。

feedback

string

可选

调查的反馈，最多320个字符。

此值默认为 “非常感谢您花时间完成调查，您的反馈确实有所作为。”。

<= 320 字符

示例值:

Thank you so much for taking the time to complete the survey. Your feedback really makes a difference.

numbered_questions

boolean

可选

是否显示问题名称中的数字。

此值默认为 “true”。

默认值:

false

示例值:

false

questions

array [object {12}]

可选

有关网络研讨会调查问题的信息。

>= 1 items<= 100 items

anonymous

boolean

可选

允许参与者匿名回答调查问题。

'true'-匿名调查已启用。

“假”-参与者不能匿名回答调查问题。

此值默认为 “true”。

默认值:

false

示例值:

false

title

string

可选

调查的标题，最多64个字符。

<= 64 字符

示例值:

Learn something new

show_question_type

boolean

可选

问题名称中是否显示问题类型。

此值默认为 “false”。

默认值:

false

示例值:

false

show_in_the_follow_up_email

boolean

可选

是否启用 ** 在后续邮件中显示链接 ** 选项。

'true'-已启用。

'false'-已禁用。

此值默认为 “false”。

默认值:

false

示例值:

false

third_party_survey

string

可选

指向第三方网络研讨会调查的链接。

<= 64 字符

示例值:

https://example.com

示例

{
    "show_in_the_browser": true,
    "custom_survey": {
        "feedback": "Thank you so much for taking the time to complete the survey. Your feedback really makes a difference.",
        "numbered_questions": false,
        "questions": [
            {
                "rating_min_label": "Not likely",
                "answer_required": false,
                "answer_min_character": 1,
                "rating_min_value": 1,
                "name": "How useful was this webinar?",
                "answers": [
                    "Extremely useful",
                    "Extremely useful"
                ],
                "type": "single",
                "rating_max_label": "Extremely Likely",
                "answer_max_character": 200,
                "rating_max_value": 4,
                "show_as_dropdown": false,
                "prompts": [
                    {
                        "prompt_question": "How are you?"
                    },
                    {
                        "prompt_question": "How are you?"
                    }
                ]
            }
        ],
        "anonymous": false,
        "title": "Learn something new",
        "show_question_type": false
    },
    "show_in_the_follow_up_email": false,
    "third_party_survey": "https://example.com"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'http://prod-cn.your-api-server.com/accounts//webinars//survey' \
--header 'Content-Type: application/json' \
--data-raw '{
    "show_in_the_browser": true,
    "custom_survey": {
        "feedback": "Thank you so much for taking the time to complete the survey. Your feedback really makes a difference.",
        "numbered_questions": false,
        "questions": [
            {
                "rating_min_label": "Not likely",
                "answer_required": false,
                "answer_min_character": 1,
                "rating_min_value": 1,
                "name": "How useful was this webinar?",
                "answers": [
                    "Extremely useful",
                    "Extremely useful"
                ],
                "type": "single",
                "rating_max_label": "Extremely Likely",
                "answer_max_character": 200,
                "rating_max_value": 4,
                "show_as_dropdown": false,
                "prompts": [
                    {
                        "prompt_question": "How are you?"
                    },
                    {
                        "prompt_question": "How are you?"
                    }
                ]
            }
        ],
        "anonymous": false,
        "title": "Learn something new",
        "show_question_type": false
    },
    "show_in_the_follow_up_email": false,
    "third_party_survey": "https://example.com"
}'

返回响应

🟢204** HTTP状态代码: ** '204' 网络研讨会调查已更新。

application/json

Body

object {0}

示例

{}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '300' 无效的网络研讨会ID。 ** 错误代码: ** '300' 无效的第三方调查: {third_party_survey}。 ** 错误码: ** '3000' 网络研讨会调查已禁用。要使用此功能，请在Zoom web门户的 “设置” 界面中启用 “网络研讨会调查” 设置。 ** 错误码: ** '3000' 不允许主持人使用第三方调查链接。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '300' 网络研讨会ID不存在。 ** 错误代码: ** '3001' 网络研讨会不存在: {webinarId}。

删除网络研讨会小组成员

获取网络研讨会调查