REST Resource: partners.devices

Recurso: Device

Um dispositivo Android ou Chrome OS registrado para o 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 IDs 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. Para saber mais, consulte 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 de 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.

  // 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

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

string

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

string

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

enum (DeviceType)

O tipo do dispositivo
chromeOsAttestedDeviceId

string

Um identificador fornecido pelos OEMs, usado 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 no ID do 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.
Campo de união hardware_id2. O segundo ID de hardware, para dispositivos dual chip. Se definido, ele precisa ser do mesmo tipo de identificador que o primeiro ID de hardware. hardware_id2 pode ser apenas de um dos tipos a seguir:
imei2

string

O segundo número IMEI do dispositivo.
meid2

string

O segundo número MEID do dispositivo.

DeviceType

O sistema operacional do dispositivo.

Enums
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo com Chrome OS

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)

As entradas de metadados são gravadas 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 com o tipo SECTION_TYPE_ZERO_TOUCH. Para saber mais, leia 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)

O 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 do registro sem toque.

AdditionalService

Serviço extra 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, você precisa se inscrever na equipe de parcerias.

Métodos

claim

 Reivindicar um dispositivo para um cliente e adicioná-lo 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

 Cancela de forma assíncrona um lote de dispositivos de um cliente.

updateMetadataAsync

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