REST Resource: partners.devices

Recurso: Device

Um dispositivo Android ou Chrome OS com registro sem toque

Representação JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ]
}
Campos
deviceId

string (int64 format)

Apenas saída. O ID do dispositivo. Atribuído pelo servidor.
deviceIdentifier

object (DeviceIdentifier)

Os códigos de hardware que identificam um dispositivo fabricado. Para saber mais, leia Identificadores.
name

string

Apenas saída. O nome do recurso da API no formato partners/[PARTNER_ID]/devices/[DEVICE_ID]. Atribuído pelo servidor.
deviceMetadata

object (DeviceMetadata)

Os metadados anexados ao dispositivo. São estruturados como pares de chave-valor. Saiba mais em Metadados do dispositivo.
claims[]

object (DeviceClaim)

Apenas saída. As declarações de provisionamento de um dispositivo. Os dispositivos reivindicados para o registro sem toque têm uma reivindicação do tipo SECTION_TYPE_ZERO_TOUCH. Chame partners.devices.unclaim ou partners.devices.unclaimAsync para remover o dispositivo do registro sem toque.

DeviceIdentifier

Encapsula o hardware e os IDs do produto para identificar um dispositivo fabricado. Para entender os requisitos dos conjuntos de identificadores, leia Identificadores.

Representação 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

O número de série do fabricante do dispositivo. Esse valor pode não ser exclusivo entre diferentes modelos de dispositivo.
manufacturer

string

O nome do fabricante do dispositivo. Corresponde ao valor integrado do dispositivo retornado de android.os.Build.MANUFACTURER. Os valores permitidos estão listados em fabricantes de Android.
model

string

O nome do modelo do dispositivo. Os valores permitidos estão listados em Modelos Android e Modelos do Chrome OS.
deviceType

enum (DeviceType)

O tipo do dispositivo
chromeOsAttestedDeviceId

string

Um identificador fornecido por OEMs, realizado durante o processo de produção e vendas. Aplicável apenas a dispositivos Chrome OS.
Campo de união hardware_id. ID de hardware com base em um ID de modem. hardware_id pode ser apenas de um dos tipos a seguir:
imei

string

O número IMEI do dispositivo. Validado na entrada.
meid

string

O número MEID do dispositivo.

DeviceType

O sistema operacional do dispositivo.

Enums
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo ChromeOS

DeviceMetadata

Entradas de metadados que podem ser anexadas a um Device. Saiba mais em Metadados do dispositivo.

Representação JSON 
{
  "entries": {
    string: string,
    ...
  }
}
Campos
entries

map (key: string, value: string)

Entradas de metadados registradas como pares de chave-valor.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DeviceClaim

Um registro de um dispositivo reivindicado por um revendedor para um cliente. Os dispositivos reivindicados para o registro sem toque têm uma reivindicação do tipo SECTION_TYPE_ZERO_TOUCH. Saiba mais em Reivindicar dispositivos para clientes.

Representação JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
Campos
sectionType

enum (DeviceProvisioningSectionType)

Apenas saída. O tipo de reivindicação feita no dispositivo.
ownerCompanyId

string (int64 format)

ID do cliente que comprou o dispositivo.
googleWorkspaceCustomerId

string

O ID da conta do Google Workspace proprietária do dispositivo Chrome OS.
resellerId

string (int64 format)

O ID do revendedor que reivindicou o dispositivo.
additionalService

enum (AdditionalService)

O serviço adicional registrado para o dispositivo.

DeviceProvisioningSectionType

O tipo de seção de um registro de provisionamento.

Enums
SECTION_TYPE_SIM_LOCK Tipo de seção de bloqueio do chip.
SECTION_TYPE_ZERO_TOUCH Tipo de seção de registro sem toque.

AdditionalService

Serviço adicional registrado para o dispositivo.

Enums
DEVICE_PROTECTION Serviço de proteção de dispositivos, também conhecido como Android Enterprise Essentials. Para reivindicar um dispositivo com o serviço de proteção para dispositivo, você precisa se inscrever com a equipe de parcerias.

Métodos

claim

 Reivindica um dispositivo para um cliente e o adiciona ao registro sem toque.

claimAsync

 reivindica um lote de dispositivos para um cliente de forma assíncrona.

findByIdentifier

 Encontra dispositivos por identificadores de hardware, como IMEI.

findByOwner

 Encontra os dispositivos reivindicados para os clientes.

get

 Recebe um dispositivo.

metadata

 Atualiza os metadados do revendedor associados ao dispositivo.

unclaim

 Cancela a reivindicação de um dispositivo de um cliente e o remove do registro sem toque.

unclaimAsync

 Cancelamento da reivindicação de um lote de dispositivos de um cliente de forma assíncrona.

updateMetadataAsync

 Atualiza os metadados do revendedor anexados a um lote de dispositivos.