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. Estruturados como pares de chave-valor.
claims[]

object (DeviceClaim)

Apenas saída. As reivindicações de provisionamento de um dispositivo. Os dispositivos reivindicados para o registro sem toque têm uma reivindicação com o 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 é null se o dispositivo não tiver uma configuração aplicada.

DeviceIdentifier

Encapsula IDs de hardware e de 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 entre 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 Chrome OS.
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 com 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 ChromeOS

DeviceMetadata

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

enum (AdditionalService)

O serviço extra 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 dispositivo, 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

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.