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)

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

string

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

string

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