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)

Los IDs 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 partners/[PARTNER_ID]/devices/[DEVICE_ID]. El servidor lo asigna.
deviceMetadata

object (DeviceMetadata)

Los metadatos adjuntos al dispositivo. Se estructuran como pares clave-valor. Para obtener más información, consulta Metadatos del dispositivo.
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 partners.devices.unclaim o partners.devices.unclaimAsync para quitar el dispositivo de la inscripción automática.

DeviceIdentifier

Encapsula los IDs de hardware y de producto 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

Es el nombre del modelo del dispositivo. Los valores permitidos se enumeran en los modelos de Android y los modelos de ChromeOS.
deviceType

enum (DeviceType)

Es 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 un 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

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

Es un registro de un dispositivo que un revendedor reclamó 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, consulta 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. Es el tipo de reclamo realizado en el dispositivo.
ownerCompanyId

string (int64 format)

Es 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
resellerId

string (int64 format)

Es el ID del revendedor que reclamó el dispositivo.
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

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

 Encuentra dispositivos por identificadores de hardware, como el IMEI.

findByOwner

 Encuentra los dispositivos reclamados por los 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

 Cancela la solicitud de un lote de dispositivos para un cliente de forma asíncrona.

updateMetadataAsync

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