REST Resource: customers

Recurso: Customer

Cuando un cliente de Google tiene una cuenta registrada con un distribuidor, este distribuidor administra las suscripciones a los servicios de Google de este cliente. Un cliente se describe mediante 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 generado por Google. En una solicitud, esta propiedad puede ser el dominio principal o el identificador único generado por Google.
customerDomain

string

La string del nombre de dominio principal del cliente. Se requiere customerDomain cuando se crea un cliente nuevo. No incluyas el prefijo www en el dominio cuando agregues a un cliente.
postalAddress

object (Address)

La información de dirección del 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 números contiguos o respetar las convenciones de formato local del teléfono, pero debe ser un número real y no, por ejemplo, "123". Este campo se ignora en silencio si no es válido.
alternateEmail

string

Al igual que el "Correo electrónico del cliente" en las herramientas del distribuidor, este correo electrónico es el contacto secundario que se utiliza si algo le sucede al servicio del cliente, como una interrupción del servicio o un problema de seguridad. Esta propiedad es obligatoria cuando se crea un nuevo cliente &dominio; no debe usar el mismo dominio que customerDomain. El campo alternateEmail no es necesario para crear un cliente de"equipo".
resourceUiUrl

string

URL al panel de control de la Consola del administrador del cliente. El servicio de API genera la URL de solo lectura. Esto se utiliza si su 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 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, consulte equipos administrados.
primaryAdmin

object (PrimaryAdmin)

Los primeros detalles de administración del cliente, presentes en caso del 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 de código de país ISO 3166. Verifique 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 de 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

La dirección física del cliente Una dirección puede tener una o tres líneas. addressline2 y addressLine3 son opcionales.
organizationName

string

El nombre de la empresa o de la división de la empresa Esto es obligatorio.
contactName

string

El nombre del contacto del cliente Esto es obligatorio.

Tipodecliente

Tipo de cliente

Enumeradores
customerTypeUnspecified Tipo de cliente desconocido
domain Clientes del dominio o del propietario del dominio
team Clientes sin dominio o verificados por correo electrónico

Administrador principal

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

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

string

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

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

Métodos

get

 Obtiene una cuenta de cliente.

insert

 Solicita 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.