REST Resource: customers.devices

Recurso: dispositivo

Un dispositivo Android o con Sistema operativo Chrome registrado para la inscripción automática.

Representación JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
Campos
deviceId

string (int64 format)

Solo salida. El ID del dispositivo. El servidor lo asigna.
deviceIdentifier

object (DeviceIdentifier)

Los ID de hardware que identifican un dispositivo fabricado. Para obtener más información, consulta Identificadores.
name

string

Solo salida. El nombre del recurso de la API en el formato customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. El servidor lo asigna.
deviceMetadata

object (DeviceMetadata)

Los metadatos adjuntos al dispositivo. Estructurado como pares clave-valor.
claims[]

object (DeviceClaim)

Solo salida. Las reclamaciones de aprovisionamiento de un dispositivo. Los dispositivos reclamados por inscripción automática tienen un reclamo del tipo SECTION_TYPE_ZERO_TOUCH. Llama a customers.devices.unclaim para quitar el dispositivo de la inscripción automática.
configuration

string

La configuración que se aplica al dispositivo en el formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. El valor es null si el dispositivo no tiene una configuración aplicada.

Identificador de dispositivo

Encapsula ID de productos y hardware para identificar un dispositivo fabricado. Para comprender los requisitos de los conjuntos de identificadores, consulta Identificadores.

Representación JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
Campos
serialNumber

string

Es el número de serie del fabricante del dispositivo. Es posible que este valor no sea único en los distintos modelos de dispositivos.
manufacturer

string

Es el nombre del fabricante del dispositivo. Coincide con el valor integrado del dispositivo que muestra android.os.Build.MANUFACTURER. Los valores permitidos se muestran en Fabricantes de Android.
model

string

El nombre del modelo del dispositivo. Los valores permitidos se enumeran en los modelos de Android y los modelos de Chrome OS.
deviceType

enum (DeviceType)

El tipo de dispositivo
chromeOsAttestedDeviceId

string

Es un identificador que proporcionan los OEM y que se lleva a cabo mediante los procesos de producción y venta. Solo se aplica a dispositivos Chrome OS.
Campo de unión hardware_id. ID de hardware basado en el ID de un módem Las direcciones (hardware_id) solo pueden ser una de las siguientes opciones:
imei

string

El número IMEI del dispositivo. Validado en la entrada.
meid

string

El número MEID del dispositivo.

DeviceType

El sistema operativo del dispositivo

Enumeradores
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo con Sistema operativo Chrome

Metadatos del dispositivo

Entradas de metadatos que se pueden adjuntar a un Device. Para obtener más información, consulta Metadatos del dispositivo.

Representación JSON 
{
  "entries": {
    string: string,
    ...
  }
}
Campos
entries

map (key: string, value: string)

Las entradas de metadatos se registran como pares clave-valor.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Reclamar dispositivo

Un registro de un dispositivo reclamado por un cliente para un cliente. Los dispositivos reclamados por inscripción automática tienen un reclamo del tipo SECTION_TYPE_ZERO_TOUCH. Para obtener más información, consulta Cómo reclamar dispositivos para clientes.

Representación JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Campos
sectionType

enum (DeviceProvisioningSectionType)

Solo salida. Es el tipo de reclamo realizado en el dispositivo.
ownerCompanyId

string (int64 format)

Es el ID del cliente que compró el dispositivo Android.
googleWorkspaceCustomerId

string

Es el ID de la cuenta de Google Workspace propietaria del dispositivo con Chrome OS.
additionalService

enum (AdditionalService)

El servicio adicional registrado para el dispositivo.

TipoDeAprovisionamientoDeDispositivo

El tipo de sección de un registro de aprovisionamiento.

Enumeradores
SECTION_TYPE_SIM_LOCK Tipo de sección de bloqueo de la SIM.
SECTION_TYPE_ZERO_TOUCH Tipo de sección de inscripción automática

Servicio adicional

Servicio adicional registrado para el dispositivo.

Enumeradores
DEVICE_PROTECTION Servicio de protección de dispositivos, también conocido como Android Enterprise Essentials. Para reclamar un dispositivo con el servicio de protección de dispositivos, debes inscribirte en el equipo de socios.

Métodos

applyConfiguration

 Aplica una configuración al dispositivo para registrar el dispositivo para la inscripción automática.

get

 Obtiene los detalles de un dispositivo.

list

 Muestra los dispositivos de un cliente.

removeConfiguration

 Quita una configuración del dispositivo.

unclaim

 Recupera un dispositivo de un cliente y lo quita de la inscripción automática.