經銷商 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。在這個版本中，Reseller API 會為 Google Workspace、Google 保管箱和 Google 雲端硬碟產品中的每個 SKU 提供訂閱項目。詳情請參閱「產品和 SKU」。