REST Resource: customers.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)
    }
  ],
  "configuration": string
}
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 customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Atribuído pelo servidor.

deviceMetadata

object (DeviceMetadata)

Os metadados anexados ao dispositivo. São estruturados como pares de chave-valor.

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

googleWorkspaceCustomerId

string

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

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

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.