Para recuperar y actualizar la información de un cliente mediante la API de revendedor, tienes dos maneras de buscarlo:
- Identificador único del cliente, por ejemplo,
C0123456
- El nombre de dominio del cliente, por ejemplo,
example.com
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.
Devoluciones de 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 revendedor, puedes administrar la configuración de la cuenta y suscripción de este cliente.
Muestra la información mínima de la cuenta del cliente. Si la respuesta solo muestra
customerId
,customerDomain
ycustomerType
, Google o algún otro distribuidor administrará al cliente. No puedes crear otro cliente verificado por correo electrónico para el cliente. Para administrar a este cliente, sigue estos pasos:- Recupera todas las suscripciones transferibles del cliente para comprender si la suscripción se puede transferir y la cantidad mínima de licencias de usuario para la transferencia.
- Transfiere la suscripción.
Muestra
Multiple teams exist on this domain
. Este dominio tiene uno o varios clientes de equipo asociados. Para agregar otro equipo a este dominio, sigue estos pasos:- Solicita una cuenta de cliente.
- Si deseas crear un cliente verificado por el dominio para el dominio, pídele que compre una suscripción directa a través de Google y verifique su dominio, aproveche los equipos existentes y, luego, transfiera la suscripción a tu cuenta.
Muestra un error HTTP
404
. El cliente es nuevo en Google y no tiene una cuenta. Para administrar a este cliente, sigue estos pasos:- Confirma que los registros de tus clientes no contengan datos antiguos de los clientes con una posible discrepancia entre el nombre de dominio principal de un cliente y el identificador único de cliente de Google. Cuando se restablece una Cuenta de Google borrada anteriormente, se trata como una cuenta nueva y tiene un valor
customerId
nuevo, aunque la cuenta pueda conservar el mismo valorcustomerDomain
. - Solicitar una cuenta nueva para clientes.
- Crea una suscripción para esta cuenta de cliente nueva.
- Confirma que los registros de tus clientes no contengan datos antiguos de los clientes con una posible discrepancia entre el nombre de dominio principal de un cliente y el identificador único de cliente de Google. Cuando se restablece una Cuenta de Google borrada anteriormente, se trata como una cuenta nueva y tiene un valor
Actualiza la configuración de un cliente
Con la API de revendedor, no puedes actualizar el customerType
, pero puedes verificar el dominio de un cliente de team
y convertirte en cliente de domain
.
Para actualizar la configuración de un cliente, usa la siguiente solicitud PUT
y, además, 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
: El dominio de tu cliente, por ejemplo,example.com
NAME
: Es el nombre de tu cliente, por ejemplo,Alex Cruz
.ORGANIZATION_NAME
: El nombre de la organización de tu cliente, por ejemplo,Example Organization
POSTAL_CODE
: El código postal de tu cliente, por ejemplo,94043
COUNTRY_CODE
: Es el código ISO de país de 2 caracteres de tu cliente.EMAIL_ADDRESS
: Es la dirección de correo electrónico de tu cliente, por ejemplo,cruz@example.com
.
Una respuesta JSON correcta muestra un código de estado HTTP 200
y la configuración actualizada del cliente:
{ "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" }