REST Resource: chromeosdevices

Resource: ChromeOsDevice

Perangkat Google Chrome dapat dijalankan 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)
}
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:

  • ACTIVE: Perangkat didaftarkan ke domain.
  • DELINQUENT: Masa berlaku lisensi tahunan untuk domain tersebut telah berakhir dan perangkat tidak lagi menerima kebijakan dan setelan. Setelah lisensi baru dibeli, perangkat akan kembali ke status ACTIVE.
  • PRE_PROVISIONED: Perangkat telah didaftarkan 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 lagi, 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 diterima.
  • RETURN_REQUESTED: Permintaan telah dibuat untuk mengganti perangkat ini.
  • SHIPPED: Perangkat dikirimkan 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 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 terakhir perangkat akan didukung. Hal ini hanya berlaku untuk perangkat yang dibeli langsung dari Google. Nilai ini 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 sebagaimana dicatat oleh administrator. Panjang maksimum adalah 100 karakter. Nilai kosong diizinkan.

annotatedLocation

string

Alamat atau lokasi perangkat sebagaimana 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 akan disertakan dalam respons.

meid

string

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

orderNumber

string

Nomor pesanan perangkat. Hanya perangkat yang langsung dibeli 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 Chrome OS 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 didaftarkan. Nilai ini 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:

  • 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 pada antarmuka jaringan ethernet.

annotatedAssetId

string

ID aset seperti yang dicatat oleh administrator atau yang 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 di perangkat dalam byte

cpuStatusReports[]

object

Laporan pemakaian dan suhu CPU (Hanya baca)

cpuStatusReports[].reportTime

string

Tanggal dan waktu laporan diterima.

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

Daftar contoh 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 maksimum dalam kHz.

cpuInfo[].logicalCpus[]

object

Informasi untuk CPU Logis

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Frekuensi maksimum CPU diizinkan untuk dijalankan, oleh kebijakan.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frekuensi saat ini tempat CPU berjalan.

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

C-States 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 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 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 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 yang setelahnya perangkat akan berhenti menerima update atau dukungan Chrome. Gunakan "autoUpdatethrough" sebagai gantinya.

ethernetMacAddress0

string

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

dockMacAddress

string

(Hanya baca) Alamat MAC bawaan untuk stasiun dok yang terhubung ke perangkat. Setelan pabrik Alamat kontrol akses media (alamat MAC) yang ditetapkan untuk digunakan oleh dok. Ini disediakan khusus untuk kebijakan perangkat lintasan MAC. Formatnya adalah dua belas (12) digit heksadesimal tanpa pembatas (huruf besar). Hal 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 terkait dengan perangkat. Nama jalur tidak peka huruf besar/kecil. Jika unit organisasi induk adalah organisasi tingkat teratas, unit organisasi 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

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 Pustaka 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 untuk perangkat Anda, lihat pusat bantuan administrasi.

osUpdateStatus

object (OsUpdateStatus)

Status update OS untuk perangkat.

firstEnrollmentTime

string

Tanggal dan waktu saat perangkat pertama kali didaftarkan.

lastDeprovisionTimestamp

string

(Hanya baca) Tanggal dan waktu untuk pencabutan 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.

autoUpdateThrough

string

Hanya output. Stempel waktu yang menandakan bahwa perangkat akan berhenti menerima dukungan atau update Chrome.

extendedSupportEligible

boolean

Hanya output. Apakah perangkat memerlukan keikutsertaan dukungan lebih lanjut atau tidak.

extendedSupportStart

string

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

extendedSupportEnabled

boolean

Hanya output. Apakah kebijakan dukungan lebih lanjut diaktifkan di perangkat.

fanInfo[]

object (FanInfo)

Hanya output. Informasi kipas untuk perangkat.

chromeOsType

enum (ChromeOsType)

Hanya output. Jenis perangkat ChromeOS.

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 OS image sedang didownload dan diterapkan. Ini hanya ditetapkan jika status pembaruan UPDATE_STATUS_DOWNLOAD_IN_PROGRESS atau UPDATE_STATUS_NEED_REBOOT. Perhatikan bahwa ini mungkin contoh "0.0.0.0" untuk UPDATE_STATUS_NEED_REBOOT untuk beberapa kasus ekstrem, misalnya, mesin pembaruan dimulai ulang tanpa memulai ulang.

targetKioskAppVersion

string

Versi platform baru yang diperlukan dari aplikasi kios yang diupdate dan yang masih dalam proses.

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 belum 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 pencabutan 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 telah berakhir untuk perangkat ini.

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 telah diupgrade atau yang lebih baru.
DEPROVISION_REASON_RETIRING_DEVICE Pensiun 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 telah dicabut aksesnya oleh Pusat Layanan Reparasi. Hanya dapat disetel oleh Pusat Servis Reparasi 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 ini memiliki Chrome Education Upgrade mandiri yang bersifat 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 pada 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 perangkat ChromeOS.

Enum
CHROME_OS_TYPE_UNSPECIFIED Jenis ChromeOS belum ditentukan.
CHROME_OS_FLEX Jenis Chrome OS: Chrome OS Flex.
CHROME_OS Jenis Chrome OS: Chrome OS.

Metode

action
(deprecated)

Sebagai gantinya, gunakan BatchChangeChromeOsDeviceStatus.

get

Mengambil properti perangkat Chrome OS.

list

Mengambil daftar perangkat Chrome OS yang diberi nomor halaman 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.