Method: customers.insert
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
新しいお客様のアカウントを注文します。
新しいお客様アカウントを注文する前に、customers.get
を使用してお客様アカウントがすでに存在するかどうかを確認します。
お客様のアカウントが Google の直接アカウントとして存在する場合、または別の販売パートナーから販売パートナー経由で購入されたお客様のアカウントとして存在する場合は、既存のお客様の販売パートナー経由で購入されたアカウントを注文するで説明されているように customerAuthToken\
を使用します。新しい顧客アカウントの注文について詳しくは、新しい顧客アカウントを注文するをご覧ください。
新しいお客様アカウントを作成したら、ユーザーを管理者としてプロビジョニングする必要があります。お客様の管理者が管理コンソールにログインし、販売パートナー経由の G Suite 契約に署名してアカウントを有効にする必要があります。販売パートナーは、お客様に代わって販売パートナーを通じて購入した G Suite に関する契約に署名することはできません。詳しくは、新しいお客様アカウントを注文するをご覧ください。
HTTP リクエスト
POST https://reseller.googleapis.com/apps/reseller/v1/customers
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ |
customerAuthToken |
string
customerAuthToken クエリ文字列は、直接契約のお客様のサブスクリプションを移行する、または別の販売パートナーのお客様のサブスクリプションを販売パートナーの管理下に移行する再販アカウントを作成する場合に必要です。これは、定期購入の移行を完了するために必要な 16 進数認証トークンです。詳しくは、管理者向けヘルプセンターをご覧ください。
|
リクエストの本文
リクエストの本文には Customer
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Customer
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/apps.order
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Method: customers.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nOrders a new customer's account.\n\nBefore ordering a new customer account, establish whether the customer account already exists using the [`customers.get`](https://developers.google.com/workspace/admin/reseller/v1/reference/customers/get)\n\nIf the customer account exists as a direct Google account or as a resold customer account from another reseller, use the `customerAuthToken\\` as described in [order a resold account for an existing customer](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#create_existing_customer). For more information about ordering a new customer account, see [order a new customer account](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#create_customer).\n\nAfter creating a new customer account, you must provision a user as an administrator. The customer's administrator is required to sign in to the Admin console and sign the G Suite via Reseller agreement to activate the account. Resellers are prohibited from signing the G Suite via Reseller agreement on the customer's behalf. For more information, see [order a new customer account](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#tos).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n\n### Request body\n\nThe request body contains an instance of [Customer](/workspace/admin/reseller/reference/rest/v1/customers#Customer).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Customer](/workspace/admin/reseller/reference/rest/v1/customers#Customer).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]