Method: subscriptions.changePlan

更新訂閱方案。適用於更新 30 天試用方案的方案，或是以按月或按年付款的年約方案訂閱彈性方案。

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

HTTP 要求

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

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

路徑參數

參數
customerId

string

可以是客戶的主網域名稱或客戶的專屬 ID。如果客戶的網域名稱有所異動，舊的網域名稱無法用於存取客戶，但客戶的專屬 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 要求必須包含交易代碼，才能享有折扣費率。此屬性為選用項目。如果訂閱項目已新增交易代碼，系統會將此屬性留空，而仍會套用現有的折扣費率 (如未空白，請只提供訂閱項目中已有的交易代碼)。如果訂閱項目尚未加入交易代碼，且這項資源留空，系統就會套用一般定價。