Method: customers.insert
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Ordina l'account di un nuovo cliente.
Prima di ordinare un nuovo account cliente, verifica se esiste già utilizzando customers.get
Se l'account cliente esiste come Account Google diretto o come account cliente rivenduto da un altro rivenditore, utilizza customerAuthToken\ come descritto in Ordinare un account rivenduto per un cliente esistente. Per ulteriori informazioni su come ordinare un nuovo account cliente, vedi Ordinare un nuovo account cliente.
Dopo aver creato un nuovo account cliente, devi eseguire il provisioning di un utente come amministratore. Per attivare l'account, l'amministratore del cliente deve accedere alla Console di amministrazione e firmare il contratto di G Suite tramite rivenditore. Ai rivenditori è vietato firmare il contratto di rivenditore G Suite per conto del cliente. Per saperne di più, vedi Ordinare un nuovo account cliente.
Richiesta HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
customerAuthToken |
string
La stringa di query customerAuthToken è obbligatoria quando crei un account rivenduto che trasferisce l'abbonamento di un cliente diretto o l'abbonamento di un altro cliente del rivenditore alla tua gestione del rivenditore. Si tratta di un token di autenticazione esadecimale necessario per completare il trasferimento dell'abbonamento. Per ulteriori informazioni, visita il Centro assistenza per gli amministratori.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Customer.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Customer appena creata.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/apps.order
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
