REST Resource: customers.devices

Resource: Perangkat

Perangkat Android atau Chrome OS yang terdaftar untuk pendaftaran zero-touch.

Representasi JSON
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
Kolom
deviceId

string (int64 format)

Hanya output. ID perangkat. Ditetapkan oleh server.

deviceIdentifier

object (DeviceIdentifier)

ID hardware yang mengidentifikasi perangkat yang diproduksi. Untuk mempelajari lebih lanjut, baca ID.

name

string

Hanya output. Nama resource API dalam format customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Ditetapkan oleh server.

deviceMetadata

object (DeviceMetadata)

Metadata yang dilampirkan ke perangkat. Distrukturkan sebagai pasangan nilai kunci.

claims[]

object (DeviceClaim)

Hanya output. Klaim penyediaan untuk sebuah perangkat. Perangkat yang diklaim untuk pendaftaran zero-touch memiliki klaim dengan jenis SECTION_TYPE_ZERO_TOUCH. Panggil customers.devices.unclaim untuk menghapus perangkat dari pendaftaran zero-touch.

configuration

string

Konfigurasi yang diterapkan ke perangkat dalam format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Nilainya adalah null jika perangkat tidak menerapkan konfigurasi.

DeviceIdentifier

Mengenkapsulasi ID hardware dan produk untuk mengidentifikasi perangkat yang diproduksi. Untuk memahami persyaratan tentang kumpulan ID, baca ID.

Representasi 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.
}
Kolom
serialNumber

string

Nomor seri produsen untuk perangkat. Nilai ini mungkin tidak unik di berbagai model perangkat.

manufacturer

string

Nama produsen perangkat. Mencocokkan nilai bawaan perangkat yang ditampilkan dari android.os.Build.MANUFACTURER. Nilai yang diizinkan tercantum di produsen Android.

model

string

Nama model perangkat. Nilai yang diizinkan tercantum di model Android dan model ChromeOS.

deviceType

enum (DeviceType)

Jenis perangkat

chromeOsAttestedDeviceId

string

ID yang diberikan oleh OEM, yang diterapkan dalam proses produksi dan penjualan. Hanya berlaku untuk perangkat ChromeOS.

Kolom union hardware_id. ID hardware berdasarkan ID modem. hardware_id hanya dapat berupa salah satu dari berikut:
imei

string

Nomor IMEI perangkat. Divalidasi pada input.

meid

string

Nomor MEID perangkat.

DeviceType

Sistem operasi perangkat.

Enum
DEVICE_TYPE_ANDROID Perangkat Android
DEVICE_TYPE_CHROME_OS Perangkat ChromeOS

DeviceMetadata

Entri metadata yang dapat dilampirkan ke Device. Untuk mempelajari lebih lanjut, baca Metadata perangkat.

Representasi JSON
{
  "entries": {
    string: string,
    ...
  }
}
Kolom
entries

map (key: string, value: string)

Entri metadata yang dicatat sebagai pasangan nilai kunci.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DeviceClaim

Data perangkat yang diklaim oleh reseller untuk pelanggan. Perangkat yang diklaim untuk pendaftaran zero-touch memiliki klaim dengan jenis SECTION_TYPE_ZERO_TOUCH. Untuk mempelajari lebih lanjut, baca Mengklaim perangkat untuk pelanggan.

Representasi JSON
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Kolom
sectionType

enum (DeviceProvisioningSectionType)

Hanya output. Jenis klaim yang dibuat pada perangkat.

ownerCompanyId

string (int64 format)

ID Pelanggan yang membeli perangkat Android.

googleWorkspaceCustomerId

string

ID akun Google Workspace yang memiliki perangkat ChromeOS.

additionalService

enum (AdditionalService)

Layanan Tambahan yang terdaftar untuk perangkat ini.

DeviceProvisioningSectionType

Jenis bagian dari data penyediaan.

Enum
SECTION_TYPE_SIM_LOCK Jenis bagian kunci SIM.
SECTION_TYPE_ZERO_TOUCH Jenis bagian pendaftaran zero-touch.

AdditionalService

Layanan tambahan yang didaftarkan untuk perangkat ini.

Enum
DEVICE_PROTECTION Layanan perlindungan perangkat, yang juga dikenal sebagai Android Enterprise Essentials. Untuk mengklaim perangkat dengan layanan perlindungan perangkat, Anda harus mendaftar ke tim kemitraan.

Metode

applyConfiguration

Menerapkan Konfigurasi ke perangkat untuk mendaftarkan perangkat ke pendaftaran zero-touch.

get

Mendapatkan detail perangkat.

list

Mencantumkan perangkat pelanggan.

removeConfiguration

Menghapus konfigurasi dari perangkat.

unclaim

Membatalkan klaim perangkat dari pelanggan dan menghapusnya dari pendaftaran zero-touch.