REST Resource: customers.devices

Recurso: Device

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. Las reclamaciones de aprovisionamiento de un dispositivo. Los dispositivos reclamados para la 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 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.
}
Campos
serialNumber

string

Es 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 enumeran en los modelos de Android y los 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 valida en la entrada.

meid

string

Es el número MEID del dispositivo.

DeviceType

El sistema operativo del dispositivo

Enumeraciones
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo con 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 del 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)

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

googleWorkspaceCustomerId

string

Es el ID de la cuenta de Google Workspace propietaria del dispositivo ChromeOS.

additionalService

enum (AdditionalService)

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

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

Métodos

applyConfiguration

Aplica una configuración al dispositivo para registrarlo con 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.