資源:ChromeOsDevice
Google Chrome 裝置須在 Chrome OS 上執行。如要進一步瞭解常見 API 工作,請參閱開發人員指南。
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 ( |
欄位 | |
---|---|
deviceId |
Chrome 裝置的專屬 ID。 |
serialNumber |
啟用裝置時輸入的 Chrome 裝置序號。這個值和管理控制台的「Chrome OS 裝置」分頁中的「序號」相同。 |
status |
裝置狀態。 可接受的值為:
|
lastSync |
裝置上次與管理控制台政策設定同步處理的日期和時間。這個值採用 ISO 8601 日期和時間格式,時間是完整日期,格式為 |
supportEndDate |
支援裝置的最終日期。這僅適用於直接向 Google 購買的裝置。這個值採用 ISO 8601 日期和時間格式,時間是完整日期,格式為 |
annotatedUser |
管理員提供的裝置使用者。長度上限為 100 個半形字元。不得為空白值。 |
annotatedLocation |
管理員提供的裝置地址或位置。長度上限為 |
notes |
管理員新增的裝置相關附註。您可以使用 list 方法的 |
model |
裝置的型號資訊。如果裝置沒有這項資訊,就不會在回應中加入這個屬性。 |
meid |
行動裝置中的 3G 行動卡片行動裝置識別碼 (MEID) 或國際行動裝置識別碼 (IMEI)。如果您將裝置新增至無線電信業者的後付服務方案,通常就會使用 MEID/IMEI。如果裝置沒有這項資訊,就不會在回應中加入這個屬性。如要進一步瞭解如何匯出 MEID/IMEI 清單,請參閱開發人員指南。 |
orderNumber |
裝置的訂單號碼。只有直接向 Google 購買的裝置才會有訂單號碼。 |
willAutoRenew |
決定裝置是否會在支援結束日期過後自動更新支援。這是唯讀屬性。 |
osVersion |
Chrome 裝置的作業系統版本。 |
platformVersion |
Chrome 裝置的平台版本。 |
firmwareVersion |
Chrome 裝置的韌體版本。 |
macAddress |
裝置的無線 MAC 位址。如果裝置沒有這項資訊,就不會包含在回應中。 |
bootMode |
裝置的啟動模式。可能的值包括:
|
lastEnrollmentTime |
裝置上次註冊的日期和時間。這個值採用 ISO 8601 日期和時間格式,時間是完整日期,格式為 |
kind |
資源的類型。如果是 Chromeosdevices 資源,則值為 |
recentUsers[] |
近期裝置使用者的清單 (依上次登入時間遞減排序)。 |
recentUsers[].type |
使用者的類型。 可接受的值為:
|
recentUsers[].email |
使用者的電子郵件地址。只有在使用者類型為 |
activeTimeRanges[] |
有效時間範圍的清單 (唯讀)。 |
activeTimeRanges[].activeTime |
使用時間長度,以毫秒為單位。 |
activeTimeRanges[].date |
使用日期。 |
ethernetMacAddress |
裝置的乙太網路網路介面上的 MAC 位址。 |
annotatedAssetId |
管理員註記的資產 ID,或在註冊過程中指定的資產 ID。 |
etag |
資源的 ETag。 |
diskVolumeReports[] |
磁碟空間和已掛接/已連線磁碟區的其他資訊報告。 |
diskVolumeReports[].volumeInfo[] |
磁碟磁碟區 |
diskVolumeReports[].volumeInfo[].volumeId |
磁碟區 ID |
diskVolumeReports[].volumeInfo[].storageTotal |
總磁碟空間 [以位元組為單位] |
diskVolumeReports[].volumeInfo[].storageFree |
可用磁碟空間 [以位元組為單位] |
systemRamTotal |
裝置上的 RAM 總量(以位元組為單位) |
cpuStatusReports[] |
CPU 使用率和溫度報告 (唯讀) |
cpuStatusReports[].reportTime |
收到報表的日期和時間。 |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
CPU 溫度樣本清單。 |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
攝氏溫度。 |
cpuStatusReports[].cpuTemperatureInfo[].label |
CPU 標籤 |
cpuInfo[] |
裝置 CPU 規格的相關資訊。 |
cpuInfo[].model |
CPU 型號名稱。 |
cpuInfo[].architecture |
CPU 架構。 |
cpuInfo[].maxClockSpeedKhz |
最大 CPU 時脈速度,以 kHz 為單位。 |
cpuInfo[].logicalCpus[] |
邏輯 CPU 相關資訊 |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
系統依政策允許執行 CPU 的頻率上限。 |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
CPU 目前的執行頻率。 |
cpuInfo[].logicalCpus[].idleDuration |
自上次開機以來的閒置時間。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
cpuInfo[].logicalCpus[].cStates[] |
C 狀態表示 CPU 的耗電量狀態。詳情請參閱 CPU 製造商發布的說明文件。 |
cpuInfo[].logicalCpus[].cStates[].displayName |
狀態名稱。 |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
上次重新啟動後處於狀態的時間。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
deviceFiles[] |
要下載的裝置檔案清單 (唯讀) |
deviceFiles[].name |
檔案名稱 |
deviceFiles[].type |
檔案類型 |
deviceFiles[].downloadUrl |
檔案下載網址 |
deviceFiles[].createTime |
檔案建立的日期和時間 |
systemRamFreeReports[] |
可用 RAM 記憶體容量的報告 (唯讀) |
systemRamFreeReports[].reportTime |
收到報表的日期和時間。 |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
包含上次已知的網路 (唯讀) |
lastKnownNetwork[].ipAddress |
IP 位址。 |
lastKnownNetwork[].wanIpAddress |
WAN IP 位址。 |
autoUpdateExpiration |
(唯讀) 裝置停止接收 Chrome 更新或支援的時間戳記。請使用「autoUpdateThrough」。 |
ethernetMacAddress0 |
(唯讀) 用於 Chromebook 內部乙太網路連接埠和內建網路 (乙太網路) 介面的 MAC 位址。格式為十二 (12) 位數的十六進制數字,不含任何分隔符號 (大寫字母)。這項功能僅適用於部分裝置。 |
dockMacAddress |
(唯讀) 裝置所連接的媒體插槽座的內建 MAC 位址。原廠設定會設定指派給座架使用的媒體存取控制位址 (MAC 位址)。這個 ID 是專為 MAC 通過裝置政策保留。格式為十二 (12) 位數的十六進制數字,不含任何分隔符號 (大寫字母)。這項功能僅適用於部分裝置。 |
manufactureDate |
(唯讀) 裝置的製造日期,格式為 yyyy-mm-dd。 |
orgUnitPath |
完整父項路徑,內含與裝置相關聯的機構單位名稱。路徑名稱不區分大小寫。如果上層機構單位是頂層機構,則會以正斜線 ( |
tpmVersionInfo |
信任平台模組 (TPM) (唯讀) |
tpmVersionInfo.family |
TPM 系列。我們使用 TPM 2.0 樣式編碼,例如: |
tpmVersionInfo.specLevel |
TPM 規格等級。請參閱 TPM 2.0 的資料庫規格和 TPM 1.2 的主要規格說明。 |
tpmVersionInfo.manufacturer |
TPM 製造商代碼。 |
tpmVersionInfo.tpmModel |
TPM 型號。 |
tpmVersionInfo.firmwareVersion |
TPM 韌體版本。 |
tpmVersionInfo.vendorSpecific |
供應商特定資訊,例如供應商 ID。 |
screenshotFiles[] |
要下載的螢幕截圖檔案清單。類型一律為「SCREENSHOT_FILE」。(唯讀) |
screenshotFiles[].name |
檔案名稱 |
screenshotFiles[].type |
檔案類型 |
screenshotFiles[].downloadUrl |
檔案下載網址 |
screenshotFiles[].createTime |
檔案建立的日期和時間 |
orgUnitId |
機構單位的專屬 ID。orgUnitPath 是人類可讀的 orgUnitId 版本。雖然您可以重新命名路徑中的機構單位,藉此變更 orgUnitPath,但有一個機構單位無法變更 orgUnitId。您可以使用 API 更新這個屬性。如要進一步瞭解如何為裝置建立機構架構,請參閱管理說明中心。 |
osUpdateStatus |
裝置的 OS 更新狀態。 |
firstEnrollmentTime |
裝置首次註冊的日期和時間。 |
lastDeprovisionTimestamp |
(唯讀) 裝置上次取消佈建的日期和時間。 |
deprovisionReason |
(唯讀) 取消佈建原因。 |
deviceLicenseType |
僅供輸出。裝置授權類型。 |
backlightInfo[] |
僅供輸出。包含裝置背光資訊。 |
autoUpdateThrough |
僅供輸出。裝置停止接收 Chrome 更新或支援的時間戳記。 |
extendedSupportEligible |
僅供輸出。裝置是否需要選擇延長支援期限。 |
extendedSupportStart |
僅供輸出。開始自動更新支援政策的裝置日期。 |
extendedSupportEnabled |
僅供輸出。是否在裝置上啟用延伸支援政策。 |
fanInfo[] |
僅供輸出。裝置的風扇資訊。 |
chromeOsType |
僅供輸出。裝置的 ChromeOS 類型。 |
OsUpdateStatus
內含目前 OS 更新狀態的相關資訊。
JSON 表示法 |
---|
{
"state": enum ( |
欄位 | |
---|---|
state |
OS 更新的更新狀態。 |
targetOsVersion |
下載及套用的 OS 映像檔新平台版本。只有在更新狀態為 UPDATE_STATUS_download_IN_PROGRESS 或 UPDATE_STATUS_NEED_REBOOT 時,才會設定此屬性。請注意,這可以是虛擬「0.0.0.0」針對某些邊緣情況執行 UPDATE_STATUS_NEED_REBOOT,例如:更新引擎在不重新啟動的情況下重新啟動。 |
targetKioskAppVersion |
適用於未推出更新版資訊站應用程式的全新必要平台版本。 |
updateTime |
上次成功 OS 更新的日期和時間。 |
updateCheckTime |
上次更新檢查的日期和時間。 |
rebootTime |
上次重新啟動的日期和時間。 |
UpdateState
OS 更新的更新狀態。
列舉 | |
---|---|
UPDATE_STATE_UNSPECIFIED |
未指定更新狀態。 |
UPDATE_STATE_NOT_STARTED |
有待處理的更新,但尚未開始。 |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
正在下載待下載更新項目, |
UPDATE_STATE_NEED_REBOOT |
裝置已準備好安裝更新,但必須重新啟動。 |
DeprovisionReason
取消佈建 ChromeOS 裝置的原因。
列舉 | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
無法得知取消佈建的原因。 |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
更換相同型號。您已取得退貨授權 (RMA),或打算將仍在保固期內的故障裝置替換為相同型號。 |
DEPROVISION_REASON_UPGRADE |
裝置已升級。 |
DEPROVISION_REASON_DOMAIN_MOVE |
已變更裝置的網域。 |
DEPROVISION_REASON_SERVICE_EXPIRATION |
裝置的服務已過期。 |
DEPROVISION_REASON_OTHER |
系統基於不再支援的舊版原因取消佈建裝置。 |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
更換其他型號的裝置。您打算將這部裝置替換為較新或升級後的型號。 |
DEPROVISION_REASON_RETIRING_DEVICE |
從機群中退除。您打算捐贈、丟棄,或以其他方式停止使用裝置。 |
DEPROVISION_REASON_UPGRADE_TRANSFER |
ChromeOS Flex 升級轉移。您會在一年內將這部 ChromeOS Flex 裝置替換為 Chromebook。 |
DEPROVISION_REASON_NOT_REQUIRED |
您不一定要提供原因。例如,授權會退回客戶的授權集區。 |
DEPROVISION_REASON_REPAIR_CENTER |
裝置已由維修服務中心取消佈建。只有退貨授權期間須由維修服務中心設定。 |
DeviceLicenseType
這部裝置的授權類型。
列舉 | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
授權類型不明。 |
ENTERPRISE |
裝置隨附永久 Chrome Enterprise 升級版。 |
ENTERPRISE_UPGRADE |
裝置搭載的是獨立年約 Chrome Enterprise 升級版。 |
EDUCATION_UPGRADE |
裝置搭載永久獨立 Chrome Education 升級版。 |
EDUCATION |
裝置隨附永久 Chrome Education 升級版。 |
KIOSK_UPGRADE |
裝置搭載的是年約 Kiosk 升級版。 |
BacklightInfo
裝置背光的相關資訊。
JSON 表示法 |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
欄位 | |
---|---|
path |
僅供輸出。到系統上的這個背光燈路徑。如果呼叫端需要與其他資訊建立關聯,則相當實用。 |
maxBrightness |
僅供輸出。背光的最大亮度。 |
brightness |
僅供輸出。背光的目前亮度,介於 0 和最大亮度之間。 |
FanInfo
裝置風扇的相關資訊。
JSON 表示法 |
---|
{ "speedRpm": integer } |
欄位 | |
---|---|
speedRpm |
僅供輸出。風扇速度 (RPM)。 |
ChromeOsType
裝置的 ChromeOS 類型。
列舉 | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
未指定 ChromeOS 類型。 |
CHROME_OS_FLEX |
Chrome OS Type Chrome OS Flex。 |
CHROME_OS |
ChromeOS 類型:ChromeOS。 |
方法 |
|
---|---|
(deprecated) |
請改用 BatchChangeChromeOsDeviceStatus。 |
|
擷取 Chrome OS 裝置的屬性。 |
|
擷取帳戶內的 Chrome OS 裝置分頁清單。 |
|
將多個 Chrome OS 裝置移動或插入至特定機構單位。 |
|
更新裝置的可更新屬性,例如 annotatedUser 、annotatedLocation 、notes 、orgUnitPath 或 annotatedAssetId 。 |
|
更新裝置的可更新屬性,例如 annotatedUser 、annotatedLocation 、notes 、orgUnitPath 或 annotatedAssetId 。 |