經銷商 API 總覽

Google 向使用者提供 Google 產品的方法之一,是透過服務發布管道,例如授權 Google Workspace 經銷商。使用經銷商 API 時,請務必瞭解經銷商與客戶之間的概念關係、付款方案、產品 SKU 和授權。

經銷商

經銷商會向 Google 購買使用者授權,然後將這些授權轉售給 Google 客戶。經銷商可以直接管理客戶的訂閱。如果自訂多項服務,經銷商則可與服務整合商合作管理客戶。

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

  • 年約:經銷商向 Google 購買一定數量的授權,效期為一年。客戶最多可以建立授權數,但是經銷商必須支付所訂購授權數的費用。如果客戶需要額外授權,經銷商可使用 subscriptions.changeSeats API 呼叫增加訂購的授權數量。
  • 彈性:每當客戶建立新使用者,Google 都會向經銷商收取這項授權的費用。經銷商與 Google 的合約說明瞭價格、規格和授權數量上限。

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

授權

授權可讓擁有 Google 帳戶的使用者存取 Google Workspace 服務。客戶將授權指派給使用者後,該授權就會成為有效授權。計算客戶的使用者總數時,只會計入有效授權。

客戶

Google 客戶是從經銷商設定的 Google Workspace 帳戶開始。設定客戶帳戶時,經銷商會提供主網域名稱、備用電子郵件地址和實際地址。然後,經銷商也會為客戶可用的每個產品 SKU 建立訂閱。客戶負責代管每個使用者帳戶。詳情請參閱「訂購新的客戶帳戶」。

計畫

方案定義經銷商與 Google 的計費條款。這些方案不會定義經銷商與客戶之間的收費關係。經銷商可以與客戶一起定義自己的帳單條款。

經銷商 API 支援 Google Workspace 月結後付款系統,其中提供數種可用的付款方案:

  • ANNUAL_MONTHLY_PAY:年約方案 (按月付款)
  • ANNUAL_YEARLY_PAY:年約方案 (按年付款)
  • FLEXIBLE:無須綁約的按月付款方案
  • TRIAL:免費試用方案
    • 試用期最長可達 30 天。
    • 每位使用者的每日 Gmail 傳送限制為 500 封郵件。
  • FREE只有 Cloud Identity 免費版訂閱才有免費方案

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

訂閱方案

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

在經銷商 API 中,訂閱項目是主要的 API 資源。其中定義付款方案、授權、30 天免費試用期、續訂和經銷商訂購單的設定。客戶可以有多個訂閱,經銷商指派給客戶的每個產品 SKU 各一個。

每個訂閱項目都有專屬的 ID,即 subscriptionId。由於 subscriptionId 會在訂閱變更時變更,因此請勿使用 subscriptionId 值做為永久資料的索引鍵。如果訂閱項目變更,這組金鑰就會失效。

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

產品和產品 SKU

「產品」是指一組特殊的 Google 服務和應用程式功能。產品可以擁有自訂版本的條款、定價和其他協議詳細資料。每個產品版本都是透過產品 SKU 識別。在此版本中,Reseller API 為 Google Workspace、Google 保管箱和 Google 雲端硬碟產品的每一個 SKU 提供一個訂閱。詳情請參閱產品與 SKU 一文。