Method: subscriptions.changePlan

更新訂閱方案。如要更新 30 天試用期的方案，或是彈性方案訂閱年約方案，可按月或按年付款。

方案的更新方式因方案和產品而異。詳情請參閱管理訂閱項目中的說明。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

這可以是客戶的主網域名稱或客戶的專屬 ID。如果客戶的網域名稱有所變更，舊網域名稱無法用於存取該客戶，但 API 會傳回客戶的專屬 ID (由 API 傳回)。建議您將專屬 ID 儲存在您的系統中 (如果適用)。
subscriptionId

string

這是必要屬性。subscriptionId 為個別客戶的訂閱 ID，且不得重複。由於 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 請求中，才能享有折扣費率。此屬性為選用項目。如果已將交易代碼加入訂閱項目，則該資源可以留空，且仍會套用現有的折扣費率 (如果沒有空白，請只提供訂閱項目現有的交易代碼)。如果從未將交易代碼加入訂閱項目，但這項資源留空，系統將套用一般定價。