更新基本计划 - Zoom API 中文版

更新子账户的基础计划。

此API只能由支付其关联的Pro或更高版本子帐户的所有账单费用的主帐户使用。Zoom仅允许已批准的合作伙伴使用主api和管理子帐户的订阅。向合作伙伴计划团队发送电子邮件至 ** partner-success@zoom.us ** 了解更多详细信息。

** 先决条件: **

子帐户必须具有Pro或更高的计划。

** 范围: ** 'billing:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api参考/速率限制 # 速率限制):** “沉重”

请求参数

Path 参数

accountId

string

帐户的ID。

必需

Body 参数application/json

有关帐户基本计划的信息。

service_effective_date

string

可选

计划在帐户上生效的日期。“service_effective_date” 和 “paid_period_start_date” 必须是相同的日期，并且必须是future。

示例值:

2021-12-31

hosts

integer

可选

客户计划的主机数量:

对于Pro计划，请提供一个介于 '1' 和 '9' 之间的值。

对于业务计划，请提供介于 “10” 和 “49” 之间的值。

对于教育计划，请提供介于 “20” 和 “149” 之间的值。

对于免费试用计划，请提供一个介于 '1' 和 '9999' 之间的值。

您 ** 必须 ** 为此字段或 “increasing_hosts” 字段提供至少一个正整数值。

示例值:

type

string

必需

科目的 [基本计划类型](https://marketplace.zoom.us/docs/api-参考/其他-参考/计划 # 基本-计划)。

示例值:

yearly

paid_period_start_date

string

可选

计划的付薪期在帐户上开始的日期。“paid_period_start_date” 和 “service_effective_date” 必须是相同的日期，并且必须是将来的日期。

示例值:

2021-12-31

increasing_hosts

integer

可选

要添加到帐户的基本计划中的其他主机的可选数量。例如，“1” 值将向现有 “20” 个主机添加一个额外的主机，总共 “21” 个主机。

您 ** 必须 ** 为此字段或 “主机” 字段提供至少一个正整数值。

示例值:

示例

{
    "service_effective_date": "2021-12-31",
    "hosts": 20,
    "type": "yearly",
    "paid_period_start_date": "2021-12-31",
    "increasing_hosts": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200** 错误代码: ** '200' * 免费试用和VIP帐户无法更新子帐户的基本计划。 * 您没有订阅。

application/json

Body

object {0}

示例

{}

🟢204** HTTPS状态码: ** '204' 已更新子帐户基础计划。

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '2100' * 此子帐户处于自助支付模式。 * 当帐户订阅捆绑计划时，无法进行更新。 * 此帐户不属于免费试用计划。 * 该帐户当前有 “{0}” 付费用户。在执行此操作之前，将用户类型更改为基本并减少付费用户的数量。 * 具有批量许可证的主帐户无法使用api配置、更新或取消子帐户的计划。使用账单门户或联系Zoom支持。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '1001' 用户不存在。 ** 错误代码: ** '2001' 帐户不存在: {subAccountId}