REST Resource: partners.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)
    }
  ]
}
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 partners/[PARTNER_ID]/devices/[DEVICE_ID]. El servidor lo asigna.

deviceMetadata

object (DeviceMetadata)

Los metadatos adjuntos al dispositivo. Estructurados como pares clave-valor Para obtener más información, consulta Metadatos del dispositivo.

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 partners.devices.unclaim o partners.devices.unclaimAsync para quitar el dispositivo de la inscripción automática.

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,
  "resellerId": 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

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

resellerId

string (int64 format)

El ID del revendedor que reclamó el dispositivo.

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

claim

Reclama un dispositivo para un cliente y lo agrega a la inscripción automática.

claimAsync

Reclama un lote de dispositivos para un cliente de forma asíncrona.

findByIdentifier

Busca dispositivos según identificadores de hardware, como IMEI.

findByOwner

Encuentra dispositivos reclamados para clientes.

get

Obtiene un dispositivo.

metadata

Actualiza los metadatos del revendedor asociados con el dispositivo.

unclaim

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

unclaimAsync

Revoca un lote de dispositivos para un cliente de forma asíncrona.

updateMetadataAsync

Actualiza los metadatos del revendedor adjuntos a un lote de dispositivos.