Method: customers.insert
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Solicita la cuenta de un cliente nuevo.
Antes de solicitar una cuenta de cliente nueva, determina si ya existe con customers.get.
Si la cuenta de cliente existe como una Cuenta de Google directa o como una cuenta de cliente revendida de otro revendedor, usa customerAuthToken\ como se describe en Cómo solicitar una cuenta revendida para un cliente existente. Para obtener más información sobre cómo solicitar una cuenta de cliente nueva, consulta Cómo solicitar una cuenta de cliente nueva.
Después de crear una cuenta de cliente nueva, debes aprovisionar un usuario como administrador. El administrador del cliente debe acceder a la Consola del administrador y firmar el Acuerdo de revendedor de G Suite para activar la cuenta. Los distribuidores no pueden firmar el Acuerdo de G Suite a través del distribuidor en nombre del cliente. Para obtener más información, consulta Cómo solicitar una cuenta de cliente nueva.
Solicitud HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
| Parámetros |
customerAuthToken |
string
La cadena de consulta customerAuthToken es obligatoria cuando se crea una cuenta revendida que transfiere la suscripción de un cliente directo o la suscripción de otro cliente revendedor a tu administración de revendedores. Este es un token de autenticación hexadecimal necesario para completar la transferencia de la suscripción. Para obtener más información, consulta el Centro de ayuda para administradores.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Customer.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Customer.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/apps.order
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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)."]]
