添加会议注册人 - Zoom API 中文版

创建并提交用户对会议的注册。有关如何设置这些字段的要求的详细信息，请参阅自定义网络研讨会注册。请注意，每个会议的最大注册人数限制为4，999人，如果达到会议的容量，用户将看到错误。

** 先决条件: **

主机必须是 ** 许可 ** 用户类型。

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

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

请求参数

Path 参数

meetingId

integer

必需

会议的ID。

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

accountId

string

帐户的唯一标识符。

必需

Query 参数

occurrence_ids

string

可选

会议发生id的逗号分隔列表。您可以使用 [get a meeting](/docs/api-reference/zoom-api/方法 # operation/meeting) api获取此值。

Body 参数application/json

有关会议注册人的信息。

zip

string

注册人的邮政编码。

可选

示例值:

94045

country

string

可选

注册人的两个字母 [国家代码](https://marketplace.zoom.us/docs/api参考/其他参考/缩写-列出 # 国家)。

示例值:

custom_questions

array [object {2}]

可选

有关自定义问题的信息。

title

string

自定义问题的标题。

可选

示例值:

What do you hope to learn from this?

value

string

可选

自定义问题的响应值。这有128个字符的限制。

<= 128 字符

示例值:

Look forward to learning how you come up with new recipes and what other services you offer.

purchasing_time_frame

enum<string>

可选

注册人的购买时间范围:

“一个月内”

'1-3个月'

'4-6个月'

“超过6个月”

'无时间帧'

枚举值:

Within a month1-3 months4-6 monthsMore than 6 monthsNo timeframe

示例值:

1-3 months

address

string

注册人的地址。

可选

示例值:

1800 Amphibious Blvd.

comments

string

可选

注册人的问题和评论。

示例值:

Looking forward to the discussion.

city

string

注册人的城市。

可选

示例值:

Mountain View

org

string

注册人的组织。

可选

示例值:

Cooking Org

last_name

string

注册人的姓氏。

可选

<= 64 字符

示例值:

Chill

no_of_employees

enum<string>

可选

注册人的员工人数:

'1-20'

'21-50'

'51-100'

'101-500'

'500-1,000'

'1,001-5,000'

'5,001-10,000'

“超过10，000”

枚举值:

1-2021-5051-100101-500500-1,0001,001-5,0005,001-10,000More than 10,000

示例值:

1-20

industry

string

注册人的行业。

可选

示例值:

Food

language

enum<string>

可选

注册人对确认电子邮件的语言偏好:

'en-US'-英语 (美国)

“de-de”-德语 (德国)

“Es-es”-西班牙语 (西班牙)

“Fr-fr”-法语 (法国)

'Jp-jp'-日语

“Pt-pt”-葡萄牙语 (葡萄牙)

'Ru-ru'-俄语

'Zh-cn'-中文 (中华人民共和国)

'Zh-tw'-中文 (台湾)

'Ko-ko'-韩语

“it-it”-意大利语 (意大利)

“vi-vn”-越南语

'pl-pl'-波兰语

'Tr-tr'-土耳其语

枚举值:

en-USde-DEes-ESfr-FRjp-JPpt-PTru-RUzh-CNzh-TWko-KOit-ITvi-VNpl-PLTr-TR

示例值:

en-US

auto_approve

boolean

可选

如果安排会议的 “approval_type” 字段值为 “1” (手动批准)，但您希望自动批准会议注册人，请将此字段的值设置为 “true”。

** 注意: ** 不能使用此字段更改 “approval_type” 字段值为 “0” (自动批准) 的原定会议的批准设置。

示例值:

true

phone

string

注册人的电话号码。

可选

示例值:

5550100

role_in_purchase_process

enum<string>

可选

注册人在购买过程中的角色:

“决策者”

“评估者/推荐者”

'影响者'

'不参与'

枚举值:

Decision MakerEvaluator/RecommenderInfluencerNot involved

示例值:

Influencer

state

string

注册人的州或省。

可选

示例值:

first_name

string

注册人的名字。

必需

<= 64 字符

示例值:

Jill

job_title

string

注册人的职称。

可选

示例值:

Chef

string <email>

必需

注册人的电子邮件地址。

<= 128 字符

示例值:

jchill@example.com

示例

{
    "zip": "94045",
    "country": "US",
    "custom_questions": [
        {
            "title": "What do you hope to learn from this?",
            "value": "Look forward to learning how you come up with new recipes and what other services you offer."
        }
    ],
    "purchasing_time_frame": "",
    "address": "1800 Amphibious Blvd.",
    "comments": "Looking forward to the discussion.",
    "city": "Mountain View",
    "org": "Cooking Org",
    "last_name": "Chill",
    "no_of_employees": "",
    "industry": "Food",
    "language": "en-US",
    "auto_approve": true,
    "phone": "5550100",
    "role_in_purchase_process": "",
    "state": "CA",
    "first_name": "Jill",
    "job_title": "Chef",
    "email": "jchill@example.com"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201** HTTP状态代码: ** '201' 会议注册已创建。

application/json

Body

occurrences

array [object {4}]

出现对象的数组。

可选

duration

integer

持续时间。

可选

示例值:

start_time

string <date-time>

开始时间。

可选

示例值:

2022-03-25T07:46:00Z

occurrence_id

string

可选

发生ID: 标识重复发生的网络研讨会的唯一标识符。定期网络研讨会最多可以出现50次。

示例值:

1648194360000

status

string

发生状态。

可选

示例值:

available

start_time

string <date-time>

会议的开始时间。

可选

示例值:

2021-07-13T21:44:51Z

join_url

string

可选

注册者可用于加入会议的URL。

如果会议是 [created](/docs/api-reference/zoom-API/methops # operation/meetingCreate)，api将不会返回此字段 “approval_type” 字段值为 “1” (手动批准)。

示例值:

https://example.com/j/11111

participant_pin_code

integer <int64>

可选

参与者PIN码用于在音频参与者加入会议之前对其进行身份验证。

示例值:

380303

registrant_id

string

注册人的身份证。

可选

示例值:

fdgsfh2ey82fuh

topic

string

会议的主题。

可选

<= 200 字符

示例值:

My Meeting

integer <int64>

会议ID。

可选

示例值:

85746065

示例

{
    "occurrences": [
        {
            "duration": 60,
            "start_time": "2022-03-25T07:46:00Z",
            "occurrence_id": "1648194360000",
            "status": "available"
        }
    ],
    "start_time": "2021-07-13T21:44:51Z",
    "join_url": "https://example.com/j/11111",
    "participant_pin_code": 380303,
    "registrant_id": "fdgsfh2ey82fuh",
    "topic": "My Meeting",
    "id": 85746065
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '1010' 用户不属于此帐户: {accountId} ** 错误代码: ** '3003' 您不是会议主持人。 ** 错误代码: ** '3043' 会议已达到最大与会者容量。 ** 错误码: ** '3000' 无法访问会议信息。 ** 错误代码: ** '3161' 您的用户帐户不允许使用会议托管和日程安排功能。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '1001' 会议主持人不存在: {userId}