REST Resource: partners.customers

Recurso: Company

Un revendedor, proveedor o cliente en las APIs de inscripción automática para revendedores y clientes.

Representación JSON
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Campos
name

string

Solo salida. El nombre del recurso de la API de la empresa. El nombre del recurso tiene uno de los siguientes formatos:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

El servidor lo asigna.

companyId

string (int64 format)

Solo salida. El ID de la empresa. El servidor lo asigna.

companyName

string

Obligatorio. Es el nombre de la empresa. Por ejemplo, XYZ Corp. Se muestra a los empleados de la empresa en el portal de inscripción automática.

ownerEmails[]

string

Obligatorio. Solo entrada. Dirección de correo electrónico de los usuarios del cliente en la función de propietario. Se requiere al menos un owner_email. Los propietarios comparten el mismo acceso que los administradores, pero también pueden agregar, borrar y editar los usuarios de tu organización.

adminEmails[]

string

Opcional. Dirección de correo electrónico de los usuarios del cliente en el rol de administrador. Cada dirección de correo electrónico debe estar asociada con una Cuenta de Google.

termsStatus

enum (TermsStatus)

Solo salida. Si algún usuario de la empresa aceptó las Condiciones del Servicio más recientes Consulta los TermsStatus.

skipWelcomeEmail

boolean

Solo entrada. Si la estableces como verdadera, no se enviará el correo electrónico de bienvenida al cliente. Se recomienda omitir el correo electrónico de bienvenida si los dispositivos se reclamarán con el servicio adicional de DEVICE_PROTECTION, ya que el cliente recibirá correos electrónicos separados cuando se reclame el dispositivo. Se ignora este campo si no se trata de un cliente de inscripción automática.

languageCode

string

Solo entrada. La configuración regional preferida del cliente, representada como un código de idioma BCP47. Este campo se valida cuando se ingresa un valor y se rechazarán las solicitudes que contengan códigos de idioma no compatibles.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Solo salida. La cuenta de Google Workspace asociada con este cliente. Solo se utiliza para las empresas de los clientes.

TermsStatus

La aceptación de la empresa de las Condiciones del Servicio de la inscripción automática Un solo usuario puede aceptar las Condiciones del Servicio para su empresa a través del portal web.

Las Condiciones del Servicio cuentan con control de versiones. Esto significa que, cuando cambian las Condiciones del Servicio, al menos un usuario debe aceptar las nuevas. Hasta que el primer usuario acepte las nuevas Condiciones del Servicio, el estado de las condiciones de la empresa será TERMS_STATUS_STALE.

Enumeraciones
TERMS_STATUS_NOT_ACCEPTED Ninguno de los usuarios de la empresa aceptó las Condiciones del Servicio.
TERMS_STATUS_ACCEPTED Uno (o más) de los usuarios de la empresa aceptó las Condiciones del Servicio.
TERMS_STATUS_STALE Ninguno de los usuarios de la empresa aceptó las Condiciones del Servicio actuales, pero al menos un usuario aceptó las anteriores.

GoogleWorkspaceAccount

Ser cliente de Google Workspace

Representación JSON
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Campos
customerId

string

Obligatorio. El ID de cliente

preProvisioningTokens[]

string

Solo salida. Los tokens de preaprovisionamiento que se usaban anteriormente para reclamar dispositivos.

Métodos

create

Crea un cliente para la inscripción automática.

list

Enumera los clientes que están inscritos en el revendedor identificado con el argumento partnerId.