REST Resource: chromeosdevices

Referensi: ChromeOsDevice

Perangkat Google Chrome berjalan di Chrome OS. Untuk informasi selengkapnya tentang tugas API umum, lihat Panduan Developer.

Representasi JSON 
{
  "deviceId": string,
  "serialNumber": string,
  "status": string,
  "lastSync": string,
  "supportEndDate": string,
  "annotatedUser": string,
  "annotatedLocation": string,
  "notes": string,
  "model": string,
  "meid": string,
  "orderNumber": string,
  "willAutoRenew": boolean,
  "osVersion": string,
  "platformVersion": string,
  "firmwareVersion": string,
  "macAddress": string,
  "bootMode": string,
  "lastEnrollmentTime": string,
  "kind": string,
  "recentUsers": [
    {
      "type": string,
      "email": string
    }
  ],
  "activeTimeRanges": [
    {
      "activeTime": integer,
      "date": string
    }
  ],
  "ethernetMacAddress": string,
  "annotatedAssetId": string,
  "etag": string,
  "diskVolumeReports": [
    {
      "volumeInfo": [
        {
          "volumeId": string,
          "storageTotal": string,
          "storageFree": string
        }
      ]
    }
  ],
  "systemRamTotal": string,
  "cpuStatusReports": [
    {
      "reportTime": string,
      "cpuUtilizationPercentageInfo": [
        integer
      ],
      "cpuTemperatureInfo": [
        {
          "temperature": integer,
          "label": string
        }
      ]
    }
  ],
  "cpuInfo": [
    {
      "model": string,
      "architecture": string,
      "maxClockSpeedKhz": integer,
      "logicalCpus": [
        {
          "maxScalingFrequencyKhz": integer,
          "currentScalingFrequencyKhz": integer,
          "idleDuration": string,
          "cStates": [
            {
              "displayName": string,
              "sessionDuration": string
            }
          ]
        }
      ]
    }
  ],
  "deviceFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "systemRamFreeReports": [
    {
      "reportTime": string,
      "systemRamFreeInfo": [
        string
      ]
    }
  ],
  "lastKnownNetwork": [
    {
      "ipAddress": string,
      "wanIpAddress": string
    }
  ],
  "autoUpdateExpiration": string,
  "ethernetMacAddress0": string,
  "dockMacAddress": string,
  "manufactureDate": string,
  "orgUnitPath": string,
  "tpmVersionInfo": {
    "family": string,
    "specLevel": string,
    "manufacturer": string,
    "tpmModel": string,
    "firmwareVersion": string,
    "vendorSpecific": string
  },
  "screenshotFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "orgUnitId": string,
  "osUpdateStatus": {
    object (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ]
}
Kolom
deviceId

string

ID unik perangkat Chrome.
serialNumber

string

Nomor seri perangkat Chrome yang dimasukkan saat perangkat diaktifkan. Nilai ini sama dengan Nomor Seri konsol Admin di tab Perangkat ChromeOS.
status

string

Status perangkat.

Nilai yang dapat diterima adalah:

  • ACTIVE: Perangkat didaftarkan ke domain.
  • DELINQUENT: Lisensi tahunan untuk domain telah habis masa berlakunya dan perangkat tidak lagi menerima kebijakan dan setelan. Jika lisensi baru dibeli, perangkat akan kembali ke status ACTIVE.
  • PRE_PROVISIONED: Perangkat telah terdaftar untuk pendaftaran zero-touch. Perangkat PRE_PROVISIONED dapat dipindahkan ke unit organisasi lain atau dihapus. Setelah pendaftaran selesai, perangkat akan menjadi ACTIVE.
  • DEPROVISIONED: Perangkat tidak lagi memenuhi syarat untuk didaftarkan ke domain. Pesanan telah dibatalkan. Setelan perangkat telah di-cache pada perangkat. Jika perangkat diaktifkan kembali, setelan sistem terbaru akan diterapkan ke perangkat yang baru diaktifkan ini.
  • DISABLED: Perangkat telah dinonaktifkan oleh administrator dan tidak dapat digunakan.
  • INACTIVE: Perangkat tidak terdaftar di domain.
  • RETURN_ARRIVED: Permintaan untuk mengganti perangkat ini telah tiba.
  • RETURN_REQUESTED: Permintaan telah dibuat untuk mengganti perangkat ini.
  • SHIPPED: Perangkat dikirim dari inventaris Google. (Tidak digunakan lagi)
  • UNKNOWN: Status perangkat tidak dapat ditentukan.
lastSync

string

Tanggal dan waktu perangkat terakhir kali disinkronkan dengan setelan kebijakan di konsol Admin. Nilai ini menggunakan format tanggal dan waktu ISO 8601. Waktu yang ditampilkan adalah tanggal lengkap plus jam, menit, dan detik dalam format YYYY-MM-DDThh:mm:ssTZD. Misalnya, 2010-04-05T17:30:04+01:00.
supportEndDate

string

Tanggal akhir perangkat akan didukung. Hal ini hanya berlaku untuk perangkat yang dibeli langsung dari Google. Nilai ini menggunakan format tanggal dan waktu ISO 8601. Waktu yang ditampilkan adalah tanggal lengkap plus jam, menit, dan detik dalam format YYYY-MM-DDThh:mm:ssTZD. Misalnya, 2010-04-05T17:30:04+01:00.
annotatedUser

string

Pengguna perangkat seperti yang dicatat oleh administrator. Panjang maksimum adalah 100 karakter. Nilai kosong diizinkan.
annotatedLocation

string

Alamat atau lokasi perangkat seperti yang dicatat oleh administrator. Panjang maksimum adalah 200 karakter. Nilai kosong diizinkan.
notes

string

Catatan tentang perangkat ini ditambahkan oleh administrator. Properti ini dapat ditelusuri dengan parameter query metode list. Panjang maksimum adalah 500 karakter. Nilai kosong diizinkan.
model

string

Informasi model perangkat. Jika perangkat tidak memiliki informasi ini, properti ini tidak disertakan dalam respons.
meid

string

Mobile Equipment Identifier (MEID) atau International Mobile Equipment Identity (IMEI) untuk kartu seluler 3G di perangkat seluler. MEID/IMEI biasanya digunakan saat menambahkan perangkat ke paket layanan pascabayar operator nirkabel. Jika perangkat tidak memiliki informasi ini, properti ini tidak disertakan dalam respons. Untuk informasi selengkapnya tentang cara mengekspor daftar MEID/IMEI, lihat Panduan Developer.
orderNumber

string

Nomor pesanan perangkat. Hanya perangkat yang dibeli secara langsung dari Google yang memiliki nomor pesanan.
willAutoRenew

boolean

Menentukan apakah perangkat akan otomatis memperpanjang dukungannya setelah tanggal akhir dukungan. Ini adalah properti hanya baca.
osVersion

string

Versi sistem operasi perangkat Chrome.
platformVersion

string

Versi platform perangkat Chrome.
firmwareVersion

string

Versi firmware perangkat Chrome.
macAddress

string

Alamat MAC nirkabel perangkat. Jika perangkat tidak memiliki informasi ini, informasi tersebut tidak disertakan dalam respons.
bootMode

string

Mode booting perangkat. Kemungkinan nilainya adalah:

  • Verified: Perangkat menjalankan versi Chrome OS yang valid.
  • Dev: Tombol hardware developer perangkat diaktifkan. Saat di-booting, perangkat memiliki shell command line. Untuk contoh pengalihan developer, lihat informasi developer Chromebook.
lastEnrollmentTime

string

Tanggal dan waktu perangkat terakhir didaftarkan. Nilai ini menggunakan format tanggal dan waktu ISO 8601. Waktu yang ditampilkan adalah tanggal lengkap plus jam, menit, dan detik dalam format YYYY-MM-DDThh:mm:ssTZD. Misalnya, 2010-04-05T17:30:04+01:00. Untuk mengetahui informasi selengkapnya tentang pendaftaran otomatis dan manual, lihat pusat bantuan Chrome.
kind

string

Jenis resource. Untuk resource Chromeosdevices, nilainya adalah admin#directory#chromeosdevice.
recentUsers[]

object

Daftar pengguna perangkat terbaru, dalam urutan menurun, berdasarkan waktu login terakhir.
recentUsers[].type

string

Jenis pengguna.

Nilai yang dapat diterima adalah:

  • USER_TYPE_MANAGED: Pengguna dikelola oleh domain.
  • USER_TYPE_UNMANAGED: Pengguna tidak dikelola oleh domain.
recentUsers[].email

string

Alamat email pengguna. Ini hanya ada jika jenis pengguna adalah USER_TYPE_MANAGED.
activeTimeRanges[]

object

Daftar rentang waktu aktif (Hanya baca).
activeTimeRanges[].activeTime

integer

Durasi penggunaan dalam milidetik.
activeTimeRanges[].date

string

Tanggal penggunaan.
ethernetMacAddress

string

Alamat MAC perangkat di antarmuka jaringan ethernet.
annotatedAssetId

string

ID aset seperti yang disebutkan oleh administrator atau ditentukan saat pendaftaran.
etag

string

ETag resource.
diskVolumeReports[]

object

Laporan kapasitas disk dan info lainnya tentang volume yang terpasang/tersambung.
diskVolumeReports[].volumeInfo[]

object

Volume disk
diskVolumeReports[].volumeInfo[].volumeId

string

ID volume
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Total kapasitas disk [dalam byte]
diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Kapasitas disk kosong [dalam byte]
systemRamTotal

string (int64 format)

Total RAM pada perangkat dalam byte
cpuStatusReports[]

object

Laporan penggunaan dan suhu CPU (Hanya baca)
cpuStatusReports[].reportTime

string

Tanggal dan waktu laporan diterima.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Daftar sampel suhu CPU.
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Suhu dalam derajat Celsius.
cpuStatusReports[].cpuTemperatureInfo[].label

string

Label CPU
cpuInfo[]

object

Informasi mengenai spesifikasi CPU di perangkat.
cpuInfo[].model

string

Nama model CPU.
cpuInfo[].architecture

string

Arsitektur CPU.
cpuInfo[].maxClockSpeedKhz

integer

Kecepatan clock CPU maksimal dalam kHz.
cpuInfo[].logicalCpus[]

object

Informasi untuk CPU Logis
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Frekuensi maksimum CPU diizinkan untuk dijalankan, berdasarkan kebijakan.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frekuensi saat ini berjalan di CPU.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Waktu tidak ada aktivitas sejak booting terakhir.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

C-State menunjukkan status konsumsi daya CPU. Untuk informasi lebih lanjut, lihat dokumentasi yang diterbitkan oleh pembuat CPU.
cpuInfo[].logicalCpus[].cStates[].displayName

string

Nama negara bagian.
cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Waktu yang dihabiskan dalam status ini sejak mulai ulang terakhir.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
deviceFiles[]

object

Daftar file perangkat untuk didownload (Hanya baca)
deviceFiles[].name

string

Nama file
deviceFiles[].type

string

Jenis file
deviceFiles[].downloadUrl

string

URL download file
deviceFiles[].createTime

string

Tanggal dan waktu file dibuat
systemRamFreeReports[]

object

Laporan jumlah memori RAM yang tersedia (Hanya baca)
systemRamFreeReports[].reportTime

string

Tanggal dan waktu laporan diterima.
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

Berisi jaringan yang terakhir diketahui (Hanya baca)
lastKnownNetwork[].ipAddress

string

Alamat IP.
lastKnownNetwork[].wanIpAddress

string

Alamat IP WAN.
autoUpdateExpiration

string (int64 format)

(Hanya baca) Stempel waktu saat perangkat akan berhenti menerima update atau dukungan Chrome
ethernetMacAddress0

string

Alamat MAC (Hanya baca) yang digunakan oleh port ethernet internal Chromebook, dan untuk antarmuka jaringan internal (ethernet). Formatnya adalah dua belas (12) digit heksadesimal tanpa pembatas (huruf besar). Ini hanya relevan untuk beberapa perangkat.
dockMacAddress

string

(Hanya-baca) Alamat MAC bawaan untuk stasiun dok yang terhubung dengan perangkat. Setelan pabrik Alamat kontrol akses media (alamat MAC) yang ditetapkan untuk digunakan oleh dok. Ini disediakan khusus untuk MAC melewati kebijakan perangkat. Formatnya adalah dua belas (12) digit heksadesimal tanpa pembatas (huruf besar). Ini hanya relevan untuk beberapa perangkat.
manufactureDate

string

(Hanya baca) Tanggal perangkat diproduksi dalam format yyyy-mm-dd.
orgUnitPath

string

Jalur induk lengkap dengan nama unit organisasi yang dikaitkan dengan perangkat. Nama jalur tidak peka huruf besar/kecil. Jika unit organisasi induk adalah organisasi tingkat teratas, unit organisasi tersebut akan dilambangkan dengan garis miring, /. Properti ini dapat diperbarui menggunakan API. Untuk informasi selengkapnya tentang cara membuat struktur organisasi bagi perangkat, lihat pusat bantuan administrasi.
tpmVersionInfo

object

Trusted Platform Module (TPM) (Hanya baca)
tpmVersionInfo.family

string

Rangkaian TPM. Kami menggunakan encoding gaya TPM 2.0, misalnya:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000
tpmVersionInfo.specLevel

string

Tingkat spesifikasi TPM. Lihat Spesifikasi Perpustakaan untuk TPM 2.0 dan Spesifikasi Utama untuk TPM 1.2.
tpmVersionInfo.manufacturer

string

Kode produsen TPM.
tpmVersionInfo.tpmModel

string

Nomor model TPM.
tpmVersionInfo.firmwareVersion

string

Versi firmware TPM.
tpmVersionInfo.vendorSpecific

string

Informasi khusus vendor, seperti ID Vendor.
screenshotFiles[]

object

Daftar file screenshot yang akan didownload. Jenisnya selalu "SCREENSHOT_FILE". (Hanya baca)
screenshotFiles[].name

string

Nama file
screenshotFiles[].type

string

Jenis file
screenshotFiles[].downloadUrl

string

URL download file
screenshotFiles[].createTime

string

Tanggal dan waktu file dibuat
orgUnitId

string

ID unik unit organisasi. orgUnitPath adalah versi orgUnitId yang dapat dibaca manusia. Meskipun orgUnitPath dapat berubah dengan mengganti nama unit organisasi dalam jalurnya, orgUnitId tidak dapat diubah untuk satu unit organisasi. Properti ini dapat diperbarui menggunakan API. Untuk informasi selengkapnya tentang cara membuat struktur organisasi bagi perangkat, lihat pusat bantuan administrasi.
osUpdateStatus

object (OsUpdateStatus)

Status update OS untuk perangkat.
firstEnrollmentTime

string

Tanggal dan waktu saat pertama kali perangkat didaftarkan.
lastDeprovisionTimestamp

string

(Hanya baca) Tanggal dan waktu cabut akses perangkat terakhir kali.
deprovisionReason

enum (DeprovisionReason)

(Hanya baca) Alasan pencabutan akses.
deviceLicenseType

enum (DeviceLicenseType)

Hanya output. Jenis lisensi perangkat.
backlightInfo[]

object (BacklightInfo)

Hanya output. Berisi informasi lampu latar untuk perangkat.

OsUpdateStatus

Berisi informasi terkait status update OS saat ini.

Representasi JSON 
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Kolom
state

enum (UpdateState)

Status update dari update OS.
targetOsVersion

string

Versi platform baru dari OS image yang didownload dan diterapkan. Ini hanya disetel ketika status update adalah UPDATE_STATUS_DOWNLOAD_IN_PROGRESS atau UPDATE_STATUS_NEED_REBOOT. Perhatikan ini bisa jadi "0.0.0.0" tiruan untuk UPDATE_STATUS_NEED_REBOOT untuk beberapa kasus ekstrem, misalnya pembaruan mesin dimulai ulang tanpa reboot.
targetKioskAppVersion

string

Versi platform baru yang diperlukan dari aplikasi kios yang diupdate dan tertunda.
updateTime

string

Tanggal dan waktu update OS terakhir yang berhasil.
updateCheckTime

string

Tanggal dan waktu pemeriksaan update terakhir.
rebootTime

string

Tanggal dan waktu mulai ulang terakhir.

UpdateState

Status update dari update OS.

Enum
UPDATE_STATE_UNSPECIFIED Status update tidak ditentukan.
UPDATE_STATE_NOT_STARTED Ada pembaruan yang tertunda, tapi belum dimulai.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS Update tertunda sedang didownload.
UPDATE_STATE_NEED_REBOOT Perangkat siap menginstal update, tetapi harus dimulai ulang.

DeprovisionReason

Alasan cabut akses perangkat ChromeOS.

Enum
DEPROVISION_REASON_UNSPECIFIED Alasan cabut akses tidak diketahui.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT Penggantian model yang sama. Anda memiliki Return Materials Authorization (RMA) atau Anda mengganti perangkat yang tidak berfungsi dengan model perangkat yang sama sesuai garansi.
DEPROVISION_REASON_UPGRADE

Perangkat telah diupgrade.
DEPROVISION_REASON_DOMAIN_MOVE

Domain perangkat telah diubah.
DEPROVISION_REASON_SERVICE_EXPIRATION

Layanan untuk perangkat telah berakhir.
DEPROVISION_REASON_OTHER

Perangkat telah dicabut aksesnya karena alasan lama yang tidak lagi didukung.
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT Penggantian model yang berbeda. Anda mengganti perangkat ini dengan model perangkat yang diupgrade atau yang lebih baru.
DEPROVISION_REASON_RETIRING_DEVICE Pensiun dari armada. Anda mendonasikan, memusnahkan, atau membuang perangkat agar tidak digunakan.
DEPROVISION_REASON_UPGRADE_TRANSFER Transfer upgrade ChromeOS Flex. Ini adalah perangkat ChromeOS Flex yang Anda ganti dengan Chromebook dalam waktu satu tahun.
DEPROVISION_REASON_NOT_REQUIRED Alasan tidak wajib diisi. Misalnya, lisensi dikembalikan ke kumpulan lisensi pelanggan.
DEPROVISION_REASON_REPAIR_CENTER Perangkat telah dicabut aksesnya oleh Pusat Reparasi. Hanya dapat disetel oleh Pusat Reparasi selama RMA.

DeviceLicenseType

Jenis lisensi perangkat ini.

Enum
DEVICE_LICENSE_TYPE_UNSPECIFIED Jenis lisensi tidak diketahui.
ENTERPRISE Perangkat ini dipaketkan dengan Chrome Enterprise Upgrade permanen.
ENTERPRISE_UPGRADE Perangkat ini memiliki Chrome Enterprise Upgrade mandiri tahunan.
EDUCATION_UPGRADE Perangkat memiliki Chrome Education Upgrade mandiri permanen.
EDUCATION Perangkat ini dipaketkan dengan Chrome Education Upgrade permanen.
KIOSK_UPGRADE Perangkat memiliki Upgrade Kios tahunan.

BacklightInfo

Informasi tentang lampu latar perangkat.

Representasi JSON 
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
Kolom
path

string

Hanya output. Jalur ke lampu latar ini di sistem. Berguna jika pemanggil perlu berkorelasi dengan informasi lain.
maxBrightness

integer

Hanya output. Kecerahan maksimum untuk lampu latar.
brightness

integer

Hanya output. Kecerahan lampu latar saat ini, antara 0 dan maxBrightness.

Metode

action
(deprecated)

 Sebagai gantinya, gunakan BatchChangeChromeOsDeviceStatus.

get

 Mengambil properti perangkat Chrome OS.

list

 Mengambil daftar perangkat Chrome OS yang telah dipaginasi dalam sebuah akun.

moveDevicesToOu

 Memindahkan atau menyisipkan beberapa perangkat Chrome OS ke unit organisasi.

patch

 Mengupdate properti perangkat yang dapat diperbarui, seperti annotatedUser, annotatedLocation, notes, orgUnitPath, atau annotatedAssetId.

update

 Mengupdate properti perangkat yang dapat diperbarui, seperti annotatedUser, annotatedLocation, notes, orgUnitPath, atau annotatedAssetId.