Method: subscriptions.suspend

暂停活跃的订阅。

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

  • 对于 FLEXIBLE 订阅,结算已暂停。
  • 对于 ANNUAL_MONTHLY_PAYANNUAL_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

有关详情,请参阅授权指南