REST Resource: partners.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)
    }
  ]
}
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. Distrukturkan sebagai pasangan nilai kunci. Untuk mempelajari lebih lanjut, baca Metadata perangkat.

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 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 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 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 ChromeOS.

deviceType

enum (DeviceType)

Jenis perangkat

chromeOsAttestedDeviceId

string

ID yang diberikan oleh OEM, yang disertakan 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,
  "resellerId": 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.

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 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

claim

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

claimAsync

Mengklaim sejumlah 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 sejumlah perangkat.