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, puedes buscar un cliente de dos maneras:

• Identificador único del cliente, por ejemplo, C0123456.
• Nombre de dominio del cliente, por ejemplo, example.com.

Recupera 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 del cliente.

Devoluciones de respuestas

Cuando recuperas 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 de este cliente y la configuración de la suscripción.

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

  1. Recupera todas las suscripciones transferibles del cliente para comprender la transferibilidad y la cantidad mínima de licencias de usuario.
  2. Transfiere la suscripción.

• Devoluciones 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 con dominio verificado, pídele que compre una suscripción directa y verifique su dominio y, luego, transfiérale la suscripción.

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

  1. Confirma que tus registros no contengan datos del cliente antiguos con una discrepancia entre el nombre de dominio principal y el identificador único del cliente de Google. Cuando se restablece una cuenta borrada, se la trata como una cuenta nueva con un customerId nuevo.
  2. Solicita una cuenta de cliente nueva.
  3. Crea una suscripción para la 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 de team para convertirlo en cliente de domain.

Para actualizar la configuración de un cliente, usa la siguiente solicitud PUT y, luego, incluye el identificador único del 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 del cliente, por ejemplo, example.com.
• NAME: Es el nombre del cliente, por ejemplo, Alex Cruz.
• ORGANIZATION_NAME: Es el nombre de la organización del cliente, por ejemplo, Example Organization.
• POSTAL_CODE: Código postal del cliente, por ejemplo, 94043
• COUNTRY_CODE: Código de país ISO de 2 caracteres del cliente.
• EMAIL_ADDRESS: Es la dirección de correo electrónico del cliente, por ejemplo, [e-mail].

Una respuesta JSON correcta devuelve 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"
}