Pedir una nueva cuenta de cliente

Antes de crear una cuenta nueva para clientes, considera lo siguiente:

Crea una cuenta para clientes

  1. Para crear una cuenta para clientes, usa la siguiente solicitud POST y 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 muestra un código de estado HTTP 409 Conflict, el customerId ya existe. Antes de registrar la cuenta del cliente, debes transferir las suscripciones del cliente.

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

  4. Promocione la al rol de administrador avanzado. Cuando crees la cuenta de administrador, puedes generar una cuenta contraseña aleatoria o solicitarle al cliente que ingrese una contraseña.

  5. Notificar al cliente que debe acceder a la Consola del administrador firme el acuerdo de Google Workspace a través del Revendedor para activar a su cuenta. Los revendedores tienen prohibido firmar las Condiciones del servicio en en nombre del cliente.

Tipos de clientes

Puedes crear dos tipos de clientes en Google Workspace:

  • Clientes verificados por el dominio. Estos clientes necesitan Gmail y necesitan acceso total de administrador. Cuando crees este tipo de cliente, configura la De customerType a domain.
  • Clientes verificados por correo electrónico. Estos clientes no son propietarios ni administradores de sus dominio. Cuando crees este tipo de cliente, establece customerType en team Estos tipos de clientes pueden comprar Essentials y Enterprise Essentials más recientes de Google Workspace.

El siguiente cuerpo de solicitud JSON es un ejemplo de un cliente verificado por el 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: Es el nombre de tu cliente, por ejemplo, Alex Cruz.
  • ORGANIZATION_NAME: La organización de tu cliente nombre, por ejemplo, Example Organization.
  • POSTAL_CODE: El código postal del cliente para Por ejemplo, 94043.
  • COUNTRY_CODE: Los 2 caracteres de tu cliente Código ISO de país.
  • EMAIL_ADDRESS: la dirección de correo electrónico de tu cliente, para Por ejemplo, cruz@example.com.

Si la respuesta es exitosa, se mostrará un código de estado 200 HTTP y el nombre del cliente nuevo información:

{
  "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 verificado por correo electrónico:

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

Si la respuesta es exitosa, se mostrará un código de estado 200 HTTP y el nombre del cliente nuevo información:

{
  "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 crear. Los usuarios existentes conservan su idioma actual incluso después de que actualizar el idioma predeterminado. Por lo tanto, debes establecer la configuración predeterminada idioma antes de crear usuarios.

Un cliente recién creado tiene un idioma predeterminado: inglés. Para cambiar el el idioma predeterminado, usa el PATCH o UPDATE llamadas desde la API de Directory Clientes extremo.

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 valor aceptado código de idioma por ejemplo, es para español.

Una respuesta JSON correcta muestra un código de estado HTTP 200 y el estado recurso para clientes:

{
  "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