REST Resource: customers.devices

Resource: Perangkat

Perangkat Android atau ChromeOS 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. Disusun 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 diterapkan ke perangkat dalam format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Nilainya adalah null jika perangkat tidak memiliki konfigurasi yang diterapkan.

DeviceIdentifier

Mengenkapsulasi ID hardware dan produk untuk mengidentifikasi perangkat yang diproduksi. Untuk memahami persyaratan pada 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.

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

string

Nomor seri produsen untuk perangkat. Nilai ini mungkin tidak berbeda 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 Chrome OS.
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.
Kolom union hardware_id2. ID hardware kedua, untuk perangkat SIM ganda. Jika ditetapkan, jenis ID harus sama dengan ID hardware pertama. hardware_id2 hanya dapat berupa salah satu dari berikut:
imei2

string

Nomor IMEI kedua perangkat.
meid2

string

Nomor MEID kedua 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 di perangkat.
ownerCompanyId

string (int64 format)

ID Pelanggan yang membeli perangkat.
googleWorkspaceCustomerId

string

ID akun Google Workspace yang memiliki perangkat ChromeOS.
additionalService

enum (AdditionalService)

Layanan tambahan yang terdaftar untuk perangkat.

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, juga dikenal sebagai Android Enterprise Essentials. Untuk mengklaim perangkat dengan layanan perlindungan perangkat, Anda harus mendaftar dengan 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.