Reseller API の概要
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Google がユーザーに Google プロダクト サービスを提供する方法の 1 つは、Google Workspace の正規販売パートナーなどのサービス配信チャネルを通じて行うことです。Reseller API を使用する場合は、販売パートナーと顧客、お支払いプラン、プロダクト SKU、ライセンスの概念的な関係を理解しておくことが重要です。
再販業者
販売パートナーは Google からユーザー ライセンスを購入し、Google のお客様に再販します。販売パートナーは、お客様のサブスクリプションを直接管理できます。また、複数のサービスをカスタマイズする場合は、サービス インテグレータと連携して、お客様を管理することもできます。
販売パートナーは次のプランから選択できます。
- 年間契約: 販売パートナーが 1 年間、Google から一定数のライセンスを購入します。お客様はライセンス数まで作成できますが、販売パートナーには注文されたライセンス数に対して請求されます。お客様が追加のライセンスを必要とする場合、販売店は
subscriptions.changeSeats
API 呼び出しを使用して、注文されたライセンス数を増やすことができます。
- flexible: お客様が新しいユーザーを作成するたびに、Google はこのライセンスの料金を販売パートナーに請求します。販売パートナーと Google の契約には、価格、仕様、ライセンスの最大数が記載されています。
販売パートナー(または提携しているサービス インテグレータ)は、ユーザー ライセンスの管理に加えて、トレーニング、プロモーション、広告、価格設定、デプロイのカスタマイズ、トラブルシューティング、メンテナンスなど、幅広い追加サービスをお客様に提供します。
ライセンス
ライセンスにより、Google アカウントを持つユーザーは Google Workspace サービスにアクセスできます。お客様がユーザーにライセンスを割り当てると、そのライセンスはアクティブなライセンスになります。お客様のユーザーの合計数を計算する際は、有効なライセンスのみがカウントされます。
お客様
Google のお客様は、販売パートナーが構成する Google Workspace アカウントから始めます。お客様のアカウントを設定する際、販売パートナーはメインのドメイン名、予備のメールアドレス、住所を提供します。また、販売パートナーは、お客様が利用できるプロダクト SKU ごとにサブスクリプションを作成します。お客様が個々のユーザー アカウントをホストします。詳しくは、新しいお客様アカウントを注文するをご覧ください。
プラン
プランは、販売パートナーと Google の間の請求条件を定義します。これらのプランでは、販売パートナーとその顧客の間の請求関係は定義されません。販売パートナーは、顧客に対して独自の請求条件を定義します。
Reseller API は、Google Workspace の月単位の後払いシステムをサポートしています。このシステムには、次のようないくつかの支払いプランがあります。
ANNUAL_MONTHLY_PAY
: 月払いの年契約
ANNUAL_YEARLY_PAY
: 年間前払いの年契約
FLEXIBLE
: 月単位のお支払いの契約期間なしプラン
TRIAL
: 無料トライアル プラン
- トライアル期間の長さは最大 30 日です。
- 1 ユーザーあたり 1 日 500 通の Gmail 送信制限。
FREE
: Cloud Identity Free Edition サブスクリプションの無料プランのみ
これらのプランの詳細については、お客様のお支払いプランを選択するをご覧ください。
サブスクリプション
サブスクリプションは、Google のお客様の支払いプランと、プロダクトの SKU、ユーザー ライセンス、30 日間の無料試用ステータス、更新オプションの関係を管理します。販売パートナーの主な役割は、Google のお客様のサブスクリプションを管理することです。
Reseller API では、サブスクリプションはプライマリ API リソースです。お支払いプラン、ライセンス、30 日間の無料試用、更新、販売パートナーの注文書の設定を定義します。お客様は、販売パートナーが割り当てたプロダクト SKU ごとに複数のサブスクリプションを持つことができます。
各サブスクリプションには一意の識別子(subscriptionId
)があります。サブスクリプションが変更されると subscriptionId
が変更されるため、永続データのキーとして subscriptionId
値を使用しないでください。サブスクリプションが変更されると、このキーは無効になります。
詳細については、サブスクリプションを管理するをご覧ください。
商品と商品 SKU
プロダクトとは、Google サービスとアプリケーションの機能の特別なセットを商用で提供するものです。プロダクトには、規約、料金、その他の契約内容の詳細のカスタマイズ バージョンを設定できます。これらの各プロダクト バージョンは、プロダクト SKU で識別されます。このバージョンでは、Reseller API は Google Workspace、Google Vault、Google ドライブの各プロダクトの SKU ごとにサブスクリプションを提供します。詳細については、プロダクトと SKU をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[],[],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)."]]