Recupera y actualiza la información de la cuenta de un cliente

Para recuperar y actualizar la información de un cliente con la API de Reseller, tienes dos maneras de buscarlo:

• Es el identificador único del cliente; por ejemplo, C0123456.
• Nombre de dominio del cliente (por ejemplo, example.com)

Cómo recuperar la información de la cuenta de un cliente

Para recuperar la información de la cuenta de un cliente, usa la siguiente solicitud GET e incluye el token de autorización:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Reemplaza CUSTOMER_ID por el identificador único o el nombre de dominio de tu cliente.

Devuelve una respuesta

Cuando recuperes la información de la cuenta de un cliente, es posible que recibas una de las siguientes respuestas:

• Devuelve la configuración completa del cliente. El cliente es uno de tus clientes existentes. Con la API de Reseller, puedes administrar la cuenta y la configuración de la suscripción de este cliente.

• Devuelve la información mínima de la cuenta del cliente. Si la respuesta solo muestra customerId, customerDomain y customerType, Google o otro distribuidor administran al cliente. No puedes crear otro cliente verificado por correo electrónico para el cliente. Para administrar a este cliente, sigue estos pasos:

  1. Obtén todas las suscripciones transferibles del cliente para comprender si se puede transferir la suscripción y la cantidad mínima de licencias de usuario para la transferencia.
  2. Transfiere la suscripción.

• Devuelve Multiple teams exist on this domain. Este dominio tiene uno o más clientes de equipo asociados. Para agregar otro equipo a este dominio, sigue estos pasos:

  1. Solicita una cuenta de cliente.
  2. Para crear un cliente verificado por el dominio, pídele que compre una suscripción directa a través de Google y verifique su dominio, tome el control de los equipos existentes y, luego, transfiera la suscripción a tu cuenta.

• Devuelve un error HTTP 404. El cliente es nuevo en Google y no tiene una cuenta. Para administrar a este cliente, sigue estos pasos:

  1. Confirma que tus registros de clientes no contengan datos de clientes anteriores con una posible discrepancia entre el nombre de dominio principal de un cliente y el identificador de cliente único de Google. Cuando se restablece una Cuenta de Google que se borró anteriormente, se considera una cuenta nueva y tiene un valor customerId nuevo, aunque la cuenta pueda retener el mismo valor customerDomain.
  2. Solicita una cuenta de cliente nueva.
  3. Crea una suscripción para esta nueva cuenta de cliente.

Actualiza la configuración de un cliente

Con la API de Reseller, no puedes actualizar el customerType, pero puedes verificar el dominio de un cliente team y convertirte en un cliente domain.

Para actualizar la configuración de un cliente, usa la siguiente solicitud PUT y, luego, incluye el identificador único de tu cliente:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

El cuerpo de la solicitud JSON actualiza la siguiente configuración del cliente:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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 de tu cliente, por ejemplo, 94043.
• COUNTRY_CODE: Es el código de país ISO de 2 caracteres de tu cliente.
• EMAIL_ADDRESS: Es la dirección de correo electrónico de tu cliente, por ejemplo, [e-mail].

Una respuesta JSON correcta muestra un código de estado HTTP 200 y la configuración del cliente actualizada:

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