Method: subscriptions.changePlan

更新订阅方案。使用此方法可将 30 天试用期或弹性方案订阅更新为包年或按月付款的包年套餐。

方案的更新方式因方案和产品而异。有关详情，请参阅管理订阅中的说明。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

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

string

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

请求正文

请求正文包含一个 ChangePlanRequest 实例。

响应正文

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

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅授权指南。

ChangePlanRequest

用于 subscription.changePlan 远程过程调用 (RPC) 请求的 JSON 模板。

JSON 表示法 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
字段
kind

string

将资源标识为订阅更改方案请求。值：subscriptions#changePlanRequest
planName

string

planName 属性是必需的。这是订阅付款方案的名称。如需详细了解 Google 付款方案，请参阅 API 概念。

可能的值包括：

  • ANNUAL_MONTHLY_PAY - 按月付款的包年套餐
  • ANNUAL_YEARLY_PAY - 包年套餐（按年付款）
  • FLEXIBLE - 弹性方案
  • TRIAL - 30 天免费试用方案
seats

object (Seats)

这是必需属性。席位属性是指用户席位许可的数量。
purchaseOrderId

string

这是一个可选属性。此采购订单 (PO) 信息供转销商用于公司跟踪使用情况。如果指定了 purchaseOrderId 值，该值会显示在 API 响应中并显示在账单中。该属性最多接受 80 个纯文本字符。
dealCode

string

订阅方案折扣价由 Google 发放的代码（最多 100 个字符）。交易代码必须包含在 changePlan 请求中才能享受折扣费率。此为可选属性。如果交易代码已添加到订阅中，此属性可能会留空，现有折扣费率仍然适用（如果不为空，请仅提供订阅中已有的交易代码）。如果系统未曾在订阅中添加交易代码，且此房源留空，则将按常规价格收费。