REST Resource: customers

Recurso: Customer

Cuando se registra la cuenta de un cliente de Google con un revendedor, este revendedor administra las suscripciones del cliente a los servicios de Google. Un cliente se describe con un nombre de dominio principal y una dirección física.

Representación JSON 
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Campos
customerId

string

Esta propiedad siempre se mostrará en una respuesta como el identificador único que genera Google. En una solicitud, esta propiedad puede ser el dominio principal o el identificador único generado por Google.
customerDomain

string

La cadena del nombre de dominio principal del cliente. customerDomain es obligatorio cuando se crea un cliente nuevo. No incluyas el prefijo www en el dominio cuando agregues un cliente.
postalAddress

object (Address)

La información de la dirección de un cliente. Cada campo tiene un límite de 255 caracteres.
phoneNumber

string

Número de teléfono de contacto del cliente Debe comenzar con "+" seguido del código de país. El resto del número pueden ser números contiguos o respetar las convenciones de formato local del teléfono, pero debe ser un número de teléfono real y no, por ejemplo, "123". Este campo se ignora en silencio si no es válido.
alternateEmail

string

Por ejemplo, "Correo electrónico del cliente" En las herramientas del distribuidor, este correo electrónico es el contacto secundario que se utiliza si ocurre algo con el servicio del cliente, como una interrupción del servicio o un problema de seguridad. Se requiere esta propiedad cuando se crea un nuevo "dominio" cliente y no debe usar el mismo dominio que customerDomain. El campo alternateEmail no es necesario para crear un "equipo". cliente.
resourceUiUrl

string

URL al panel de la Consola del administrador del cliente. El servicio de API genera la URL de solo lectura. Se usa si tu aplicación cliente requiere que el cliente complete una tarea en la Consola del administrador.
customerDomainVerified

boolean

Si el dominio principal del cliente se verificó.
kind

string

Identifica el recurso como un cliente. Valor: reseller#customer
customerType

enum (CustomerType)

Identifica el tipo de cliente. Entre los valores aceptables, se incluyen los siguientes:

  • domain: Implica un cliente verificado por el dominio (predeterminado).
  • team: implica un cliente verificado por correo electrónico.

Para obtener más información, consulta equipos administrados.
primaryAdmin

object (PrimaryAdmin)

Los primeros detalles del administrador del cliente, presentes en el caso de un cliente de TEAM.

Dirección

Plantilla JSON para la dirección de un cliente.

Representación JSON 
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Campos
countryCode

string

Para obtener información sobre countryCode, consulta los elementos del código de país ISO 3166. Verifica que el país esté aprobado para la reventa de productos de Google. Esta propiedad es obligatoria cuando se crea un cliente nuevo.
kind

string

Identifica el recurso como una dirección de cliente. Valor: customers#address
region

string

Un ejemplo de un valor region es CA para el estado de California.
addressLine2

string

Línea 2 de la dirección.
locality

string

Un ejemplo de un valor locality es la ciudad de San Francisco.
addressLine3

string

Línea 3 de la dirección.
postalCode

string

Un ejemplo de postalCode es un código postal, como 94043. Esta propiedad es obligatoria cuando se crea un cliente nuevo.
addressLine1

string

Es la dirección física de un cliente. Una dirección puede estar compuesta por una a tres líneas. addressline2 y addressLine3 son opcionales.
organizationName

string

Es el nombre de la empresa o de su división. Esto es obligatorio.
contactName

string

El nombre del contacto del cliente. Esto es obligatorio.

CustomerType

Tipo de cliente

Enumeraciones
customerTypeUnspecified Tipo de cliente desconocido
domain Clientes del dominio o que son propietarios del dominio
team Clientes sin dominio o verificados por correo electrónico

PrimaryAdmin

Plantilla de JSON para el administrador principal en el caso de los clientes de EQUIPO

Representación JSON 
{
  "primaryEmail": string
}
Campos
primaryEmail

string

El correo electrónico empresarial del administrador principal del cliente.

El vínculo de verificación por correo electrónico se envía a esta dirección cuando se crea el cliente. Los administradores principales tienen acceso a la Consola del administrador del cliente, incluida la capacidad de invitar y expulsar a usuarios y de administrar las necesidades administrativas del cliente.

Métodos

get

 Obtiene una cuenta de cliente.

insert

 Realiza el pedido de la cuenta de un cliente nuevo.

patch

 Actualiza la configuración de la cuenta de un cliente.

update

 Actualiza la configuración de la cuenta de un cliente.