Method: customers.insert
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zamawia konto nowego klienta.
Zanim zamówisz nowe konto klienta, sprawdź, czy takie konto już istnieje, korzystając z customers.get.
Jeśli konto klienta istnieje jako bezpośrednie konto Google lub jako konto klienta od innego sprzedawcy, użyj customerAuthToken\ zgodnie z opisem w artykule Zamawianie konta klienta od innego sprzedawcy. Więcej informacji o zamawianiu nowego konta klienta znajdziesz w artykule Zamawianie nowego konta klienta.
Po utworzeniu nowego konta klienta musisz skonfigurować użytkownika jako administratora. Aby aktywować konto, administrator klienta musi zalogować się w konsoli administracyjnej i podpisać umowę G Suite via Reseller. Sprzedawcy nie mogą podpisywać umowy dotyczącej G Suite w imieniu sprzedawcy w imieniu klienta. Więcej informacji znajdziesz w artykule Zamawianie nowego konta klienta.
Żądanie HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry |
customerAuthToken |
string
Parametr zapytania customerAuthToken jest wymagany podczas tworzenia konta sprzedawcy, które przenosi subskrypcję klienta indywidualnego lub przenosi subskrypcję innego klienta sprzedawcy do zarządzania przez sprzedawcę. To szesnastkowy token uwierzytelniania potrzebny do przeniesienia subskrypcji. Więcej informacji znajdziesz w Centrum pomocy dla administratorów.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu Customer.
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję Customer.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/apps.order
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
