REST Resource: chromeosdevices

Referensi: ChromeOsDevice

Perangkat Google Chrome berjalan di ChromeOS. 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)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType),
  "diskSpaceUsage": {
    object (ByteUsage)
  }
}
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 terdaftar ke domain.
  • DELINQUENT: Masa berlaku lisensi tahunan untuk domain telah habis dan perangkat tidak lagi menerima kebijakan dan setelan. Saat 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 di 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 ke domain.
  • RETURN_ARRIVED: Permintaan untuk mengganti perangkat ini telah diterima.
  • 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. Nilainya dalam format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam bentuk 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. Nilainya dalam format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam bentuk 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 yang 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 akan 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 akan disertakan dalam respons. Untuk informasi selengkapnya tentang cara mengekspor daftar MEID/IMEI, lihat Panduan Developer.
orderNumber

string

Nomor pesanan perangkat. Hanya perangkat yang dibeli 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 akan disertakan dalam respons.
bootMode

string

Mode booting untuk perangkat. Kemungkinan nilainya adalah:

  • Verified: Perangkat menjalankan versi ChromeOS yang valid.
  • Dev: Tombol hardware developer perangkat diaktifkan. Saat booting, perangkat memiliki shell command line. Untuk contoh tombol developer, lihat Informasi developer Chromebook.
lastEnrollmentTime

string

Tanggal dan waktu perangkat terakhir kali didaftarkan. Nilainya dalam format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam bentuk YYYY-MM-DDThh:mm:ssTZD. Misalnya, 2010-04-05T17:30:04+01:00. Untuk 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 dicatat oleh administrator atau ditentukan selama pendaftaran.
etag

string

ETag resource.
diskVolumeReports[]

object

Laporan kapasitas disk dan info lainnya tentang volume yang terpasang/terhubung.
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)

Ruang disk kosong [dalam byte]
systemRamTotal

string (int64 format)

Total RAM di perangkat dalam byte
cpuStatusReports[]

object

Laporan suhu dan penggunaan 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 terkait spesifikasi CPU di perangkat.
cpuInfo[].model

string

Nama model CPU.
cpuInfo[].architecture

string

Arsitektur CPU.
cpuInfo[].maxClockSpeedKhz

integer

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

object

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

integer

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

integer

Frekuensi saat ini yang dijalankan CPU.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Waktu tidak ada aktivitas sejak booting terakhir.

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

object

Status C menunjukkan status konsumsi daya CPU. Untuk informasi selengkapnya, lihat dokumentasi yang dipublikasikan oleh pembuat CPU.
cpuInfo[].logicalCpus[].cStates[].displayName

string

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

string (Duration format)

Waktu yang dihabiskan dalam status sejak mulai ulang terakhir.

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

object

Daftar file perangkat yang akan 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 terakhir yang diketahui (Hanya baca)
lastKnownNetwork[].ipAddress

string

Alamat IP.
lastKnownNetwork[].wanIpAddress

string

Alamat IP WAN.
autoUpdateExpiration
(deprecated)

string (int64 format)

(Hanya baca) Stempel waktu setelah perangkat berhenti menerima update atau dukungan Chrome. Sebagai gantinya, gunakan "autoUpdateThrough".
ethernetMacAddress0

string

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

string

(Hanya baca) Alamat MAC bawaan untuk stasiun dok yang terhubung ke perangkat. Pabrik menetapkan Alamat kontrol akses media (alamat MAC) yang ditetapkan untuk digunakan oleh dok. Alamat ini dicadangkan khusus untuk kebijakan perangkat pass-through MAC. Formatnya adalah dua belas (12) digit heksadesimal tanpa pemisah (huruf besar). Hal ini hanya relevan untuk beberapa perangkat.
manufactureDate

string

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

string

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

object

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

string

Keluarga TPM. Kita 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 Library 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 jalur, orgUnitId tidak dapat diubah untuk satu unit organisasi. Properti ini dapat diperbarui menggunakan API. Untuk informasi selengkapnya tentang cara membuat struktur organisasi untuk perangkat Anda, lihat pusat bantuan administrasi.
osUpdateStatus

object (OsUpdateStatus)

Status update OS untuk perangkat.
firstEnrollmentTime

string

Tanggal dan waktu pertama kali perangkat didaftarkan.
lastDeprovisionTimestamp

string

(Hanya baca) Tanggal dan waktu untuk penghapusan penyediaan terakhir perangkat.
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.
autoUpdateThrough

string

Hanya output. Stempel waktu setelah perangkat berhenti menerima update atau dukungan Chrome.
extendedSupportEligible

boolean

Hanya output. Apakah perangkat memerlukan keikutsertaan dukungan yang diperpanjang atau tidak.
extendedSupportStart

string

Hanya output. Tanggal perangkat saat kebijakan dukungan yang diperpanjang untuk update otomatis dimulai.
extendedSupportEnabled

boolean

Hanya output. Apakah kebijakan dukungan yang diperpanjang diaktifkan di perangkat.
fanInfo[]

object (FanInfo)

Hanya output. Informasi kipas untuk perangkat.
chromeOsType

enum (ChromeOsType)

Hanya output. Jenis Chrome OS perangkat.
diskSpaceUsage

object (ByteUsage)

Hanya output. Jumlah kapasitas disk yang tersedia dan saat ini digunakan 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 update OS.
targetOsVersion

string

Versi platform baru image OS yang didownload dan diterapkan. Nilai ini hanya ditetapkan jika status update adalah UPDATE_STATUS_DOWNLOAD_IN_PROGRESS atau UPDATE_STATUS_NEED_REBOOT. Perhatikan bahwa ini dapat berupa "0.0.0.0" dummy untuk UPDATE_STATUS_NEED_REBOOT untuk beberapa kasus ekstrem, misalnya mesin update dimulai ulang tanpa mulai ulang.
targetKioskAppVersion

string

Versi platform baru yang diperlukan dari aplikasi kios yang diupdate yang 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 update OS.

Enum
UPDATE_STATE_UNSPECIFIED Status update tidak ditentukan.
UPDATE_STATE_NOT_STARTED Ada update yang tertunda, tetapi 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 pencabutan akses perangkat ChromeOS.

Enum
DEPROVISION_REASON_UNSPECIFIED Alasan penghapusan penyediaan 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

Masa berlaku layanan untuk perangkat telah berakhir.
DEPROVISION_REASON_OTHER

Akses perangkat dicabut 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 Dihapus dari inventaris. 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 diperlukan. Misalnya, lisensi dikembalikan ke kumpulan lisensi pelanggan.
DEPROVISION_REASON_REPAIR_CENTER Perangkat dicabut aksesnya oleh Pusat Layanan Reparasi. Hanya dapat ditetapkan oleh Repair Service Center selama RMA.

DeviceLicenseType

Jenis lisensi perangkat ini.

Enum
DEVICE_LICENSE_TYPE_UNSPECIFIED Jenis lisensi tidak diketahui.
ENTERPRISE Perangkat dipaketkan dengan Chrome Enterprise Upgrade permanen.
ENTERPRISE_UPGRADE Perangkat memiliki Chrome Enterprise Upgrade mandiri tahunan.
EDUCATION_UPGRADE Perangkat memiliki Chrome Education Upgrade mandiri permanen.
EDUCATION Perangkat dipaketkan dengan Chrome Education Upgrade permanen.
KIOSK_UPGRADE Perangkat memiliki Kiosk Upgrade 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.

FanInfo

Informasi tentang kipas perangkat.

Representasi JSON 
{
  "speedRpm": integer
}
Kolom
speedRpm

integer

Hanya output. Kecepatan kipas dalam RPM.

ChromeOsType

Jenis Chrome OS perangkat.

Enum
CHROME_OS_TYPE_UNSPECIFIED Jenis Chrome OS tidak ditentukan.
CHROME_OS_FLEX Chrome OS Jenis Chrome OS Flex.
CHROME_OS Chrome OS Jenis Chrome OS.

ByteUsage

Merepresentasikan kapasitas data dengan sejumlah penggunaan saat ini dalam byte.

Representasi JSON 
{
  "capacityBytes": string,
  "usedBytes": string
}
Kolom
capacityBytes

string (int64 format)

Hanya output. Nilai kapasitas total, dalam byte.
usedBytes

string (int64 format)

Hanya output. Nilai penggunaan saat ini, dalam byte.

Metode

action
(deprecated)

 Sebagai gantinya, gunakan BatchChangeChromeOsDeviceStatus.

get

 Mengambil properti perangkat Chrome OS.

list

 Mengambil daftar perangkat Chrome OS yang di-pagination dalam akun.

moveDevicesToOu

 Memindahkan atau menyisipkan beberapa perangkat Chrome OS ke unit organisasi.

patch

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

update

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