REST Resource: customers

Recurso: Cliente

Cuando la cuenta de un cliente de Google se registra con un distribuidor, este 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 que genera Google.
customerDomain

string

Es la cadena de 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 puede ser de números contiguos o respetar las convenciones de formato local de teléfonos, pero debe ser un número de teléfono real y no, por ejemplo, "123". Este campo se ignora de forma silenciosa si no es válido.
alternateEmail

string

Al igual que el “correo electrónico del cliente” en las herramientas para revendedores, este correo electrónico es el contacto secundario que se usa si ocurre algo con el servicio del cliente, como una interrupción del servicio o un problema de seguridad. Esta propiedad es obligatoria cuando se crea un cliente "dominio" nuevo y no debe usar el mismo dominio que customerDomain. No es necesario el campo alternateEmail para crear un cliente de "equipo".
resourceUiUrl

string

Es la URL del 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

Indica si se verificó el dominio principal del cliente.
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 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 equipo

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 de los códigos 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 de 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

Es la 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

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

string

El nombre de la empresa o división de la empresa. 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 con dominios o propietarios de dominios
team Clientes sin dominio o con verificación por correo electrónico

PrimaryAdmin

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

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

string

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

El vínculo de verificación por correo electrónico se envía a esta dirección de correo electrónico en el momento de la creación del cliente. Los administradores principales tienen acceso a la Consola del administrador del cliente, lo que incluye la capacidad de invitar y desalojar a los usuarios, y administrar las necesidades administrativas del cliente.

Métodos

get

 Obtiene una cuenta de cliente.

insert

 Solicita la cuenta de un cliente nuevo.

patch

 Actualiza la configuración de una cuenta de cliente.

update

 Actualiza la configuración de una cuenta de cliente.