Pedir una nueva cuenta de cliente

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

Cómo crear una cuenta de cliente

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

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

  2. Dentro de la cuenta del cliente nuevo, crea un usuario. Si la respuesta muestra un código de estado HTTP 409 Conflict, significa que el 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 pedirle al cliente que proporcione una.

  5. Notifica al cliente que debe acceder a la Consola del administrador de Google y firmar el acuerdo de Google Workspace para distribuidores para activar su cuenta. Los distribuidores 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 dominio verificado: 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, establece customerType en team. Estos clientes pueden comprar las ediciones de Google Workspace Essentials y Google Workspace Enterprise Essentials.

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

{
  "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: El dominio del cliente, por ejemplo, example.com.
  • NAME: El nombre del cliente, por ejemplo, Alex Cruz.
  • ORGANIZATION_NAME: El nombre de la organización del cliente, por ejemplo, Example Organization.
  • POSTAL_CODE: El código postal del cliente, por ejemplo, 94043.
  • COUNTRY_CODE: El código de país ISO de 2 caracteres del cliente.
  • EMAIL_ADDRESS: La dirección de correo electrónico del cliente, por ejemplo, cruz@example.com.

Una respuesta correcta muestra 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 muestra 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. Los usuarios existentes conservan su idioma después de que actualizas el idioma predeterminado. Por lo tanto, establece el idioma predeterminado del cliente antes de crear usuarios.

Un cliente nuevo tiene el inglés como idioma predeterminado. Para cambiar el idioma predeterminado, usa los PATCH o UPDATE métodos del extremo Customers de la API de Directory.

Usa la API de Directory para actualizar el valor language predeterminado de 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: Un identificador único para el cliente, por ejemplo, C0123456.
  • LANGUAGE_CODE: Un código de idioma aceptado, por ejemplo, es para español.

Una respuesta JSON correcta muestra 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