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 produsen. 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. Terstruktur sebagai pasangan nilai kunci.
claims[]

object (DeviceClaim)

Hanya output. Penyediaan mengklaim 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 produk dan hardware 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 untuk berbagai model perangkat.
manufacturer

string

Nama produsen perangkat. Cocok dengan nilai bawaan perangkat yang ditampilkan dari android.os.Build.MANUFACTURER. Nilai yang diizinkan tercantum dalam produsen Android.
model

string

Nama model perangkat. Nilai yang diizinkan tercantum dalam model Android dan model Chrome OS.
deviceType

enum (DeviceType)

Jenis perangkat
chromeOsAttestedDeviceId

string

ID yang diberikan oleh OEM, yang dilakukan melalui proses produksi dan penjualan. Hanya berlaku untuk perangkat Chrome OS.
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.

JenisPerangkat

Sistem operasi perangkat.

Enumerasi
DEVICE_TYPE_ANDROID Perangkat Android
DEVICE_TYPE_CHROME_OS Perangkat Chrome OS

Metadata Perangkat

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 dicatat sebagai pasangan nilai kunci.

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

Klaim Perangkat

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 Chrome OS.
additionalService

enum (AdditionalService)

Layanan tambahan yang terdaftar untuk perangkat.

JenisBagian Penyediaan Perangkat

Jenis bagian dari data penyediaan.

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

Layanan Tambahan

Layanan tambahan yang terdaftar untuk perangkat.

Enumerasi
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 untuk 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.