REST Resource: partners.devices

Resource: Device

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)
    }
  ]
}
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 partners/[PARTNER_ID]/devices/[DEVICE_ID]. Ditetapkan oleh server.
deviceMetadata

object (DeviceMetadata)

Metadata yang dilampirkan ke perangkat. Disusun sebagai pasangan nilai kunci. Untuk mempelajari lebih lanjut, baca Metadata perangkat.
claims[]

object (DeviceClaim)

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

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 unik di berbagai model perangkat.
manufacturer

string

Nama produsen perangkat. Cocok dengan 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 dalam 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 dicatat sebagai pasangan nilai kunci.

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

DeviceClaim

Kumpulan 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,
  "resellerId": 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.
resellerId

string (int64 format)

ID reseller yang mengklaim perangkat.
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 terdaftar untuk perangkat.

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

claim

 Mengklaim perangkat untuk pelanggan dan menambahkannya ke pendaftaran zero-touch.

claimAsync

 Mengklaim batch perangkat untuk pelanggan secara asinkron.

findByIdentifier

 Menemukan perangkat berdasarkan ID hardware, seperti IMEI.

findByOwner

 Menemukan perangkat yang diklaim untuk pelanggan.

get

 Mendapatkan perangkat.

metadata

 Memperbarui metadata reseller yang terkait dengan perangkat.

unclaim

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

unclaimAsync

 Membatalkan klaim batch perangkat untuk pelanggan secara asinkron.

updateMetadataAsync

 Memperbarui metadata reseller yang dilampirkan ke batch perangkat.