Pedir una nueva cuenta de cliente

Antes de crear una cuenta de cliente nueva, ten en cuenta lo siguiente:

• Es posible que se apliquen restricciones de código de país. Para confirmar que el país del cliente está aprobado para la reventa, consulta Partner Sales Console.
• Si la cuenta se creó a partir de una actualización de una cuenta de Gmail para consumidores a un correo electrónico empresarial con un nombre de dominio, asegúrate de que la cuenta tenga desbloqueada la configuración adicional de Google Workspace. Para obtener más información, consulta Cómo crear correos electrónicos empresariales para tu equipo y Cómo crear un alias de correo electrónico empresarial.

Cómo crear una cuenta de cliente

1. Para crear una cuenta de cliente, usa la siguiente solicitud POST e incluye el token de autorización:

   POST https://reseller.googleapis.com/apps/reseller/v1/customers
   

2. En la cuenta del cliente nuevo, crea un usuario. Si la respuesta devuelve un código de estado HTTP 409 Conflict, el objeto customerId ya existe. Antes de registrar la cuenta del cliente, debes transferir sus suscripciones.

3. Si corresponde, cambia el idioma predeterminado del cliente.

4. Promueve al usuario al rol de administrador avanzado. Cuando crees la cuenta de administrador, puedes generar una contraseña temporal aleatoria o solicitarle al cliente que proporcione una.

5. Notifica al cliente que debe acceder a la Consola del administrador y firmar el acuerdo de Google Workspace a través del revendedor para activar su cuenta. Los revendedores no pueden firmar las Condiciones del Servicio en nombre del cliente.

Tipos de clientes

Puedes crear dos tipos de clientes en Google Workspace:

• Clientes con dominios verificados Estos clientes necesitan Gmail y acceso completo de administrador. Cuando crees este tipo de cliente, establece customerType en domain.
• Clientes con correo electrónico verificado Estos clientes no son propietarios de su dominio ni lo administran. Cuando crees este tipo de cliente, configura customerType como team. Este tipo de clientes pueden comprar las ediciones Essentials y Enterprise Essentials de Google Workspace.

El siguiente cuerpo de solicitud JSON es un ejemplo de un cliente verificado por dominio:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Reemplaza lo siguiente:

• DOMAIN_NAME: Es el dominio de tu cliente, por ejemplo, example.com.
• NAME: El nombre de tu cliente, por ejemplo, Alex Cruz.
• ORGANIZATION_NAME: Es el nombre de la organización de tu cliente, por ejemplo, Example Organization.
• POSTAL_CODE: Es el código postal del cliente, por ejemplo, 94043.
• COUNTRY_CODE: Es el código de país ISO de 2 caracteres de tu cliente.
• EMAIL_ADDRESS: La dirección de correo electrónico de tu cliente, por ejemplo, cruz@example.com.

Una respuesta correcta devuelve un código de estado HTTP 200 y la información del cliente nuevo:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

El siguiente cuerpo de solicitud JSON es un ejemplo de un cliente con correo electrónico verificado:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Una respuesta correcta devuelve un código de estado HTTP 200 y la información del cliente nuevo:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Cómo cambiar el idioma predeterminado de un cliente

El idioma predeterminado de un cliente solo se aplica a los usuarios nuevos cuando se crean. Los usuarios existentes conservarán su idioma actual incluso después de que actualices el idioma predeterminado. Por lo tanto, debes establecer el idioma predeterminado del cliente antes de crear usuarios.

Un cliente recién creado tiene el inglés como idioma predeterminado. Para cambiar el idioma predeterminado, usa las llamadas PATCH o UPDATE del extremo Customers de la API de Directory.

Usa la API de Directory para actualizar el valor predeterminado de language para un cliente:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Incluye el siguiente cuerpo de solicitud JSON:

{
  "language":"LANGUAGE_CODE"
}

Reemplaza lo siguiente:

• CUSTOMER_ID: Es un identificador único para tu cliente, por ejemplo, C0123456.
• LANGUAGE_CODE: Un código de idioma aceptado (por ejemplo, es para español)

Una respuesta JSON correcta devuelve un código de estado HTTP 200 y el recurso del cliente actualizado:

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Próximos pasos

• Errores comunes de la API de Reseller
• Errores comunes de la API de Directory