Method: subscriptions.suspend

暂停有效的订阅。

您可以使用此方法暂停当前处于 ACTIVE 状态的付费订阅。

  • 对于 FLEXIBLE 订阅，系统会暂停结算。
  • 对于 ANNUAL_MONTHLY_PAY 或 ANNUAL_YEARLY_PAY 订阅：
    • 暂停订阅不会更改原先承诺的续订日期。
    • 已暂停的订阅不会续订。如果您在原始续订日期之后激活订阅，系统会创建新的包年订阅，并从激活之日起开始计算。

我们强烈建议您仅暂停短期订阅，因为暂停超过 60 天可能会导致订阅被取消。

HTTP 请求

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

这可以是客户的主域名，也可以是客户的唯一标识符。如果客户的域名发生变化，则无法使用旧域名访问该客户，但可以随时使用客户的唯一标识符（由 API 返回）。我们建议您在系统中存储唯一标识符（如果适用）。
subscriptionId

string

这是必需属性。subscriptionId 是订阅标识符，每个客户都有唯一的标识符。由于订阅更新时 subscriptionId 会发生变化，因此我们建议您不要将此 ID 用作永久性数据的键。您可以使用检索所有转销商订阅方法找到 subscriptionId。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 Subscription 实例。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/apps.order

如需了解详情，请参阅授权指南。