REST Resource: customers.devices

Recurso: Dispositivo

Un dispositivo Android o ChromeOS 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. Es el ID del dispositivo. El servidor lo asigna.
deviceIdentifier

object (DeviceIdentifier)

Son los IDs de hardware que identifican a 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 Estructurados como pares clave-valor
claims[]

object (DeviceClaim)

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

string

Es la configuración aplicada al dispositivo en el formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. El valor es null si no se aplicó una configuración al dispositivo.

DeviceIdentifier

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.

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

string

El número de serie del fabricante del dispositivo Es posible que este valor no sea único en diferentes 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 enumeran en Fabricantes de Android.
model

string

El nombre del modelo del dispositivo. Los valores permitidos se indican en Modelos de Android y Modelos de ChromeOS.
deviceType

enum (DeviceType)

El tipo de dispositivo
chromeOsAttestedDeviceId

string

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

string

El número IMEI del dispositivo Se validó en la entrada.
meid

string

Es el número MEID del dispositivo.
Campo de unión hardware_id2. Es el segundo ID de hardware para dispositivos con doble SIM. Si se establece, debe ser del mismo tipo de identificador que el primer ID de hardware. Las direcciones (hardware_id2) solo pueden ser una de las siguientes opciones:
imei2

string

El segundo número IMEI del dispositivo.
meid2

string

El segundo número MEID del dispositivo.

DeviceType

El sistema operativo del dispositivo

Enumeraciones
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo ChromeOS

DeviceMetadata

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)

Entradas de metadatos registradas como pares clave-valor.

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

DeviceClaim

Un registro de un dispositivo reclamado por un revendedor para un cliente. Los dispositivos reclamados para la inscripción automática tienen un reclamo con el tipo SECTION_TYPE_ZERO_TOUCH. Para obtener más información, lee 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. El tipo de reclamo realizado en el dispositivo.
ownerCompanyId

string (int64 format)

Indica el ID del cliente que compró el dispositivo.
googleWorkspaceCustomerId

string

El ID de la cuenta de Google Workspace a la que pertenece el dispositivo ChromeOS
additionalService

enum (AdditionalService)

Es el servicio adicional registrado para el dispositivo.

DeviceProvisioningSectionType

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

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

AdditionalService

Es el servicio adicional registrado para el dispositivo.

Enumeraciones
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 con el equipo de socios.

Métodos

applyConfiguration

 Aplica una configuración al dispositivo para registrarlo en la inscripción automática.

get

 Obtiene los detalles de un dispositivo.

list

 Indica los dispositivos de un cliente.

removeConfiguration

 Quita una configuración del dispositivo.

unclaim

 Anula el reclamo de un dispositivo a un cliente y lo quita de la inscripción automática.