Method: customers.insert
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Faz o pedido de uma conta de cliente nova.
Antes de solicitar uma nova conta de cliente, verifique se ela já existe usando o customers.get.
Se a conta do cliente existir como uma conta direta do Google ou como uma conta de cliente revendida de outro revendedor, use o customerAuthToken\ conforme descrito em pedir uma conta revendida para um cliente. Para mais informações sobre como pedir uma nova conta de cliente, consulte Pedir uma nova conta de cliente.
Depois de criar uma nova conta de cliente, você precisa provisionar um usuário como administrador. O administrador do cliente precisa fazer login no Admin Console e assinar o contrato de revendedor do G Suite para ativar a conta. Os revendedores não podem assinar o G Suite por meio de um contrato de revendedor em nome do cliente. Para mais informações, consulte Pedir uma nova conta de cliente.
Solicitação HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
| Parâmetros |
customerAuthToken |
string
A string de consulta customerAuthToken é necessária ao criar uma conta de revenda que transfere a assinatura de um cliente direto ou de outro cliente de revendedor para o gerenciamento de revendedor. É um token de autenticação hexadecimal necessário para concluir a transferência da assinatura. Para mais informações, consulte a Central de Ajuda para administradores.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de Customer.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Customer.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/apps.order
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
