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

subscriptions.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)

这是必需属性。seats 属性是用户席位许可数。
purchaseOrderId

string

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

string

Google 签发的代码（最多 100 个字符），用于享受订阅方案的折扣价格。changePlan 请求中必须包含特惠代码，才能享受折扣费率。此为可选属性。如果订阅中已添加特惠代码，则可以将此属性留空，系统仍会应用现有的折扣费率（如果不为空，请仅提供订阅中已有的特惠代码）。如果订阅从未添加特惠代码，并且此属性留空，则系统会采用常规价格。