經銷商 API 總覽

Google 提供 Google 產品服務給使用者的方式之一，就是透過服務發布通路，例如授權的 Google Workspace 經銷商。使用 Reseller API 時，請務必瞭解經銷商與客戶、付款方案、產品 SKU 和授權的概念關係。

經銷商

經銷商會向 Google 購買使用者授權，然後轉售給 Google 客戶。經銷商可以直接管理客戶訂閱項目，如果您要自訂多項服務，則可以與服務整合服務供應商合作，管理客戶。

經銷商可以選擇下列方案：

  • 年約：經銷商向 Google 購買一年期的固定授權數量。客戶可以建立的授權數量上限為授權數量，但經銷商會根據訂購的授權數量付費。如果客戶需要額外授權，經銷商可以使用 subscriptions.changeSeats API 呼叫來提高訂購的授權數量。
  • 彈性：每當客戶建立新使用者時，Google 就會向經銷商收取此授權費用。經銷商與 Google 簽訂的合約會說明價格、規格和授權數量上限。

除了管理使用者授權，經銷商 (或其合作的服務整合商) 還會為客戶提供多項額外服務，例如訓練、促銷、廣告、定價、部署自訂化、疑難排解和維護。

授權

授權可讓具備 Google 帳戶的使用者存取 Google Workspace 服務。當客戶將授權指派給使用者後，該授權就會變成有效授權。計算客戶的使用者總數時，系統只會計入有效授權。

客戶

Google 客戶會先取得經銷商設定的 Google Workspace 帳戶。設定客戶帳戶時，經銷商會提供主要網域名稱、備用電子郵件地址和實體地址。接著，經銷商也會為客戶提供的每個產品 SKU 建立訂閱項目。客戶會代管每個個別使用者帳戶。詳情請參閱「訂購新的客戶帳戶」。

計畫

方案會定義經銷商與 Google 的帳單條款。這些方案不會定義經銷商與其客戶之間的帳單關係。經銷商可自行與客戶定義帳單條款。

Reseller API 支援 Google Workspace 月付後付系統，該系統提供多種付款方案：

  • ANNUAL_MONTHLY_PAY：年約方案，每月付款
  • ANNUAL_YEARLY_PAY：年繳方案，每年付款一次
  • FLEXIBLE：無綁約方案，每月付款
  • TRIAL：免費試用方案
    • 試用期長度可變動，最長為 30 天。
    • 每位使用者每日 Gmail 傳送限制為 500 封郵件。
  • FREE：適用於 Cloud Identity 免費版訂閱方案的免費方案 (僅限)

如要進一步瞭解這些方案，請參閱「為客戶選擇付款方案」。

訂閱

訂閱項目會管理 Google 客戶的付款方案與產品 SKU、使用者授權、30 天免費試用狀態和續約選項的關係。經銷商的主要角色是管理 Google 客戶的訂閱項目。

在 Reseller API 中，訂閱是主要的 API 資源。其中定義了付款方案、授權、30 天免費試用期、續約和經銷商的訂購單設定。客戶可以擁有多個訂閱方案，每個產品 SKU 對應一個訂閱方案。

每個訂閱項目都有專屬 ID subscriptionId。由於訂閱項目變更時，subscriptionId 也會變更，因此請勿將 subscriptionId 值用做永久性資料的鍵。如果訂閱項目有所變更，這個鍵就會中斷。

詳情請參閱「管理訂閱項目」。

產品和產品 SKU

產品是指提供特定 Google 服務和應用程式功能的商業產品。產品可以有自訂版本的條款、價格和其他協議詳細資料。每個產品版本都會以產品 SKU 識別。在這個版本中，經銷商 API 會為 Google Workspace、Google 保管箱和 Google 雲端硬碟產品中的每個 SKU 提供訂閱項目。詳情請參閱「產品與 SKU」一文。