經銷商 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」。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[],[],null,["# Reseller API overview\n\nOne of the ways Google offers Google product services to users is through\nservice distribution channels such as the authorized Google Workspace resellers.\nWhen working with the Reseller API, it's important to understand the\nconceptual relationships of resellers to customers, payment plans, product SKUs,\nand licenses.\n\nReseller\n--------\n\nA reseller buys user licenses from Google and resells these licenses to Google\ncustomers. A reseller can manage customer subscriptions directly, or, if\ncustomizing multiple services, a reseller can work with a service integrator to\nmanage customers.\n\nResellers can choose from the following plans:\n\n- **annual commitment:** The reseller purchases a fixed amount of licenses from Google for one year. Customers can create up to the license count, but resellers are billed for the number of licenses ordered. If customers need additional licenses, resellers can use the [`subscriptions.changeSeats`](/workspace/admin/reseller/v1/reference/subscriptions/changeSeats) API call to raise the number of licenses ordered.\n- **flexible:** Every time a customer creates a new user, Google charges the reseller for this license. The reseller's contract with Google describes the price, specifications, and maximum number of licenses.\n\nAlong with managing user licenses, the reseller (or its partnered service\nintegrators) provide customers with a broad range of additional services such as\ntraining, promotions, advertising, pricing, deployment customizations,\ntroubleshooting, and maintenance.\n\nLicenses\n--------\n\nA license lets a user with a Google account access Google Workspace\nservices. When a customer assigns a license to a user, it becomes an active\nlicense. Only active licenses are counted when calculating a customer's total\nnumber of users.\n\nCustomer\n--------\n\nA Google customer begins with a Google Workspace account that the\nreseller configures. When setting up the customer's account, the reseller\nsupplies a primary domain name, alternate email, and a physical address. Then,\nthe reseller also creates a subscription for each product SKU available to the\ncustomer. The customer hosts each individual user account. For more information,\nsee\n[Order a new customer account](/workspace/admin/reseller/v1/how-tos/manage_customers#order_a_new_customer_account).\n\nPlans\n-----\n\nA plan defines a reseller's billing terms with Google. These plans don't define\nthe billing relationship between a reseller and their customers. Resellers\ndefine their own billing terms with their customers.\n\nReseller API\nsupports the Google Workspace monthly post-pay system, which has several available\npayment plans:\n\n- `ANNUAL_MONTHLY_PAY`: Annual commitment with monthly payments\n- `ANNUAL_YEARLY_PAY`: Annual commitment with one yearly payment\n- `FLEXIBLE`: Non-commitment plan with monthly payments\n- `TRIAL`: Free trial plan\n - Trial length is variable up to a maximum of 30 days.\n - Daily Gmail sending limit of 500 messages per user.\n- `FREE`: Free plan **only** for Cloud Identity Free Edition subscriptions\n\nFor more information on these plans, see\n[Choose a payment plan for your customers](https://support.google.com/a/answer/1720041).\n\nSubscription\n------------\n\nA subscription manages the relationship of a Google customer's\npayment plan with a product's SKU, user licenses, 30-day free trial status, and\nrenewal options. A primary role of a reseller is to manage the Google customer's\nsubscriptions.\n\nIn the Reseller API, a subscription is a primary API resource. It\ndefines the settings for a payment plan, licenses, 30-day free trial, renewal,\nand a reseller's purchase order. A customer can have more than one subscription,\none for each product SKU that the reseller assigns to the customer.\n\nEach subscription has a unique identifier, a `subscriptionId`. Because a\n`subscriptionId` changes when the subscription changes, don't use a\n`subscriptionId` value as a key for persistent data. This key will break if the\nsubscription changes.\n\nFor more information, see [Manage subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions).\n\nProducts and product SKUs\n-------------------------\n\nA product is a commercial offering of a specialized set of Google service and\napplication features. A product can have customized versions of terms, pricing,\nand other agreement details. Each of these product versions is identified by a\nproduct SKU. In this version, the Reseller API offers a subscription\nfor each SKU in the Google Workspace, Google Vault, and Google Drive products.\nFor more information, see\n[Products \\& SKUs](/workspace/admin/reseller/v1/how-tos/products)."]]
