REST Resource: customers.devices

Recurso: dispositivo

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)
    }
  ],
  "configuration": string
}
Campos
deviceId

string (int64 format)

Apenas saída. 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 customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Atribuído pelo servidor.

deviceMetadata

object (DeviceMetadata)

Os metadados anexados ao dispositivo. Estruturados como pares de chave-valor.

claims[]

object (DeviceClaim)

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

configuration

string

A configuração aplicada ao dispositivo no formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. O valor será null se o dispositivo não tiver uma configuração aplicada.

DeviceIdentifier

Encapsula os IDs de hardware e produto para identificar um dispositivo fabricado. Para entender os requisitos nos 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 em diferentes modelos de dispositivos.

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 Android.

model

string

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

deviceType

enum (DeviceType)

O tipo do dispositivo

chromeOsAttestedDeviceId

string

Um identificador fornecido por OEMs, realizado pelo processo de produção e vendas. Aplicável apenas aos dispositivos Chrome OS.

Campo de união hardware_id. ID de hardware baseado 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 Chrome OS

Metadados do dispositivo

Entradas de metadados que podem ser anexadas a um Device. Para saber mais, leia 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" }.

Reivindicação de dispositivos

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. Para saber mais, leia Reivindicar dispositivos para clientes.

Representação JSON
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": 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 Android.

googleWorkspaceCustomerId

string

Mostra o ID da conta do Google Workspace proprietária do dispositivo Chrome OS.

additionalService

enum (AdditionalService)

O serviço adicional registrado para o dispositivo.

TipoDeSeçãoDeProvisionamentoDeDispositivo

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.

Serviço adicional

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 de dispositivo, você precisa se inscrever na equipe de parceria.

Métodos

applyConfiguration

Aplica uma configuração ao dispositivo para registrá-lo no registro sem toque.

get

Recebe os detalhes de um dispositivo.

list

Lista os dispositivos de um cliente.

removeConfiguration

Remove uma configuração do dispositivo.

unclaim

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