REST Resource: customers.telemetry.devices

資源：TelemetryDevice

收集自受管理裝置的遙測資料。

  • 需要精細權限：TELEMETRY_API_DEVICE
JSON 表示法 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
欄位
name

string

僅供輸出。裝置的資源名稱。
customer

string

僅供輸出。已註冊裝置的 Google Workspace 客戶。
orgUnitId

string

僅供輸出。裝置的機構單位 ID。
deviceId

string

僅供輸出。裝置的專屬 Directory API ID。這個值和 ChromeOS 裝置分頁中管理控制台的 Directory API ID
serialNumber

string

僅供輸出。裝置序號。這個值和管理控制台在 ChromeOS 裝置分頁中的序號相同。
cpuInfo[]

object (CpuInfo)

僅供輸出。裝置的 CPU 規格相關資訊。
cpuStatusReport[]

object (CpuStatusReport)

僅供輸出。系統會定期收集 CPU 狀態報告 (依 reportTime 遞減順序)。
memoryInfo

object (MemoryInfo)

僅供輸出。裝置記憶體規格的相關資訊。
memoryStatusReport[]

object (MemoryStatusReport)

僅供輸出。收集的記憶體狀態報表會定期依 reportTime 減少排序。
networkInfo

object (NetworkInfo)

僅供輸出。網路裝置資訊。
networkStatusReport[]

object (NetworkStatusReport)

僅供輸出。定期收集網路規格。
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

僅供輸出。定期收集的網路診斷資料。
osUpdateStatus[]

object (OsUpdateStatus)

僅供輸出。包含 ChromeOS 更新狀態的相關資訊。
graphicsInfo

object (GraphicsInfo)

僅供輸出。內含裝置圖形週邊裝置的相關資訊。
graphicsStatusReport[]

object (GraphicsStatusReport)

僅供輸出。定期收集的圖形報告。
batteryInfo[]

object (BatteryInfo)

僅供輸出。裝置電池規格的資訊。
batteryStatusReport[]

object (BatteryStatusReport)

僅供輸出。電池報告會定期收集。
storageInfo

object (StorageInfo)

僅供輸出。裝置儲存空間規格的資訊。
storageStatusReport[]

object (StorageStatusReport)

僅供輸出。系統會定期收集儲存空間報表。
thunderboltInfo[]

object (ThunderboltInfo)

僅供輸出。Thunderbolt 公車的資訊。
audioStatusReport[]

object (AudioStatusReport)

僅供輸出。系統會定期收集音訊報表 (依 reportTime 遞減順序)。
bootPerformanceReport[]

object (BootPerformanceReport)

僅供輸出。裝置啟動效能報告。
heartbeatStatusReport[]

object (HeartbeatStatusReport)

僅供輸出。活動訊號狀態報表內含時間戳記，時間戳記會定期以「reportTime」遞減順序排序
kioskAppStatusReport[]

object (KioskAppStatusReport)

僅供輸出。資訊站裝置的資訊站應用程式狀態報告
networkBandwidthReport[]

object (NetworkBandwidthReport)

僅供輸出。定期收集的網路頻寬報表 (依 reportTime 的遞減順序排列)。
peripheralsReport[]

object (PeripheralsReport)

僅供輸出。定期收集的周邊裝置報表 (依 reportTime 遞減排序)。
runtimeCountersReport[]

object (RuntimeCountersReport)

僅供輸出。執行階段計數器會回報裝置生命週期的執行階段，以及 S0->S3、S0->S4 和 S0->S5 轉場次數，也就是進入睡眠、休眠和關機狀態的次數

CpuInfo

裝置的 CPU 規格

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceCpuInfo
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_CPU_INFO
JSON 表示法 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
欄位
model

string

僅供輸出。CPU 型號名稱。例如：Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
architecture

enum (Architecture)

僅供輸出。CPU 的架構類型。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceCpuInfo
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
maxClockSpeed

integer

僅供輸出。最大 CPU 時脈速度，kHz。
keylockerSupported

boolean

僅供輸出。是否支援 Keylocker。
keylockerConfigured

boolean

僅供輸出。是否已設定 Keylocker。TRUE = 已啟用；FALSE = 已停用。只有在 keylockerSupported = TRUE 時才會回報。

架構

CPU 的架構類型。

列舉
ARCHITECTURE_UNSPECIFIED 架構未知。
X64 x64 架構

CpuStatusReport

提供 CPU 狀態的資訊。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceCpuInfo
  • 資料收集頻率：每 10 分鐘
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_CPU_REPORT
JSON 表示法 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
欄位
reportTime

string (Timestamp format)

僅供輸出。時間戳記 (以毫秒為單位)，代表系統取樣這份報表的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
sampleFrequency

string (Duration format)

僅供輸出。取樣報表的取樣頻率。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
cpuUtilizationPct

integer

僅供輸出。CPU 使用率範例 (0 - 100%)。
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

僅供輸出。攝氏個別 CPU 核心的 CPU 溫度樣本資訊

CpuTemperatureInfo

裝置的 CPU 溫度。以攝氏為單位對每個 CPU 核心進行取樣。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceCpuInfo
  • 資料收集頻率：每 10 分鐘
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
JSON 表示法 
{
  "temperatureCelsius": integer,
  "label": string
}
欄位
temperatureCelsius

integer

僅供輸出。CPU 溫度 (攝氏)。
label

string

僅供輸出。CPU 標籤範例：核心 0

MemoryInfo

裝置的記憶體資訊。

  • 這個欄位含有遙測和裝置資訊：
    • totalRamBytes - 裝置資訊
    • availableRamBytes - 遙測資訊
    • totalMemoryEncryption - 裝置資訊
  • 這個欄位的資料是透過政策控制：ReportDeviceMemoryInfo
  • 資料收集頻率：
    • totalRamBytes - 只在上傳時
    • availableRamBytes - 每 10 分鐘
    • totalMemoryEncryption - 裝置啟動時
  • 預設資料報表頻率：
    • totalRamBytes - 3 小時
    • availableRamBytes - 3 小時
    • totalMemoryEncryption - 裝置啟動時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，收集到的資料會儲存在本機，並且會在裝置下次連上網路時回報：僅適用於 totalMemoryEncryption
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_MEMORY_INFO
JSON 表示法 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
欄位
totalRamBytes

string (int64 format)

僅供輸出。RAM 總量 (以位元組為單位)。
availableRamBytes

string (int64 format)

僅供輸出。可用 RAM 容量 (以位元組為單位)。
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

僅供輸出。裝置的記憶體加密總資訊。

TotalMemoryEncryptionInfo

裝置的記憶體加密資訊。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceMemoryInfo
  • 資料收集頻率：裝置啟動時
  • 預設資料回報頻率：裝置啟動時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：是
  • 僅回報關聯使用者的數據：不適用
JSON 表示法 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
欄位
encryptionState

enum (MemoryEncryptionState)

裝置的記憶體加密狀態。
maxKeys

string (int64 format)

可用於加密的金鑰數量上限。
keyLength

string (int64 format)

加密金鑰的長度。
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

記憶體加密演算法。

MemoryEncryptionState

裝置的記憶體加密狀態。

列舉
MEMORY_ENCRYPTION_STATE_UNSPECIFIED 未設定記憶體加密狀態。
MEMORY_ENCRYPTION_STATE_UNKNOWN 記憶體加密狀態不明。
MEMORY_ENCRYPTION_STATE_DISABLED 裝置記憶體強化功能已停用。
MEMORY_ENCRYPTION_STATE_TME 裝置的記憶體加密會使用記憶體總量加密。
MEMORY_ENCRYPTION_STATE_MKTME 裝置的記憶體加密功能採用多金鑰總記憶體加密。

MemoryEncryptionAlgorithm

裝置使用的加密演算法。

列舉
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED 未設定記憶體加密演算法。
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN 目前使用的記憶體加密演算法不明。
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 記憶體加密演算法使用 AES_XTS 加密演算法搭配 128 位元的區塊密碼。
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 記憶體加密演算法使用 AES_XTS 加密演算法與 256 位元的區塊密碼演算法。

MemoryStatusReport

包含記憶體狀態報告的範例。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceMemoryInfo
  • 資料收集頻率：只有在上傳時，系統每 10 分鐘會收集一次 SystemRamFreeByes 一次
  • 預設資料報表頻率：每 3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_MEMORY_REPORT
JSON 表示法 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
欄位
reportTime

string (Timestamp format)

僅供輸出。時間戳記 (以毫秒為單位)，代表系統取樣這份報表的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
sampleFrequency

string (Duration format)

僅供輸出。取樣報表的取樣頻率。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
systemRamFreeBytes

string (int64 format)

僅供輸出。可用 RAM 容量 (以位元組為單位，因垃圾收集造成的不穩定)。
pageFaults

integer

僅供輸出。這個集合期間的頁面錯誤數量

NetworkInfo

網路裝置資訊。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過 ReportNetworkDeviceConfiguration 政策控制
  • 資料收集頻率：裝置啟動時
  • 預設資料回報頻率：裝置啟動時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：是
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_NETWORK_INFO
JSON 表示法 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
欄位
networkDevices[]

object (NetworkDevice)

僅供輸出。網路裝置清單。

NetworkDevice

網路裝置的詳細資料。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過 ReportNetworkDeviceConfiguration 政策控制
  • 資料收集頻率：裝置啟動時
  • 預設資料回報頻率：裝置啟動時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：是
  • 僅回報關聯使用者的數據：不適用
JSON 表示法 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
欄位
type

enum (NetworkDeviceType)

僅供輸出。網路裝置類型。
macAddress

string

僅供輸出。對應網路裝置的 MAC 位址 (如適用)。
meid

string

僅供輸出。對應網路裝置的 MEID (如有)。
imei

string

僅供輸出。對應網路裝置的 IMEI (如適用)。
iccid

string

僅供輸出。與裝置 SIM 卡相關聯的整合式電路卡 ID。
mdn

string

僅供輸出。與裝置 SIM 卡相關聯的行動目錄號碼。

NetworkDeviceType

網路裝置類型。

列舉
NETWORK_DEVICE_TYPE_UNSPECIFIED 未指定網路裝置類型。
CELLULAR_DEVICE 。
ETHERNET_DEVICE 乙太網路裝置。
WIFI_DEVICE Wi-Fi 裝置。

NetworkStatusReport

可見/設定網路的狀態。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過 ReportNetworkStatus 政策控管
  • 資料收集頻率：60 分鐘
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：是
  • 僅針對關聯使用者回報：是
  • 需要精細的權限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType)
}
欄位
reportTime

string (Timestamp format)

僅供輸出。回報網路狀態的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
sampleFrequency

string (Duration format)

僅供輸出。取樣報表的取樣頻率。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
signalStrengthDbm

integer

僅供輸出。無線網路的訊號強度 (以分貝為單位)。
lanIpAddress

string

僅供輸出。LAN IP 位址。
gatewayIpAddress

string

僅供輸出。閘道 IP 位址。
transmissionBitRateMbps

string (int64 format)

僅供輸出。傳輸位元率 (以百萬位元/秒為單位)。
receivingBitRateMbps

string (int64 format)

僅供輸出。接收位元率的測量單位為每秒百萬位元數。
transmissionPowerDbm

integer

僅供輸出。傳輸功率 (以分貝為單位)。
encryptionOn

boolean

僅供輸出。Wi-Fi 加密金鑰是否已關閉。
wifiPowerManagementEnabled

boolean

僅供輸出。已啟用 Wi-Fi 電源管理功能
guid

string

僅供輸出。網路連線指南。
connectionState

enum (NetworkConnectionState)

僅供輸出。網路目前的連線狀態。
connectionType

enum (NetworkType)

僅供輸出。網路連線類型。

NetworkType

網路連線類型。

列舉
NETWORK_TYPE_UNSPECIFIED 未指定網路連線類型
CELLULAR 行動網路連線。
ETHERNET 乙太網路網路連線。
TETHER 網路連線。
VPN VPN 網路連線。
WIFI Wi-Fi 網路連線。

NetworkDiagnosticsReport

判斷裝置網路連線狀況的網路測試結果，例如 HTTPS 延遲時間是高還是正常。

  • 需要精細的權限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
欄位
reportTime

string (Timestamp format)

僅供輸出。診斷時間時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
httpsLatencyData

object (HttpsLatencyRoutineData)

僅供輸出。HTTPS 延遲測試資料。

OsUpdateStatus

包含目前 OS 更新狀態的相關資訊。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceOsUpdateStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_OS_REPORT
JSON 表示法 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
欄位
updateState

enum (UpdateState)

僅供輸出。OS 更新的目前狀態。
newPlatformVersion

string

僅供輸出。系統正在下載並套用新的 OS 映像檔平台版本。只有在更新狀態為 OS_IMAGE_DOWNLOAD_IN_PROGRESS 或 OS_UPDATE_NEED_REBOOT 時才會設定。請注意，對於某些極端案例，這可能是 OS_UPDATE_NEED_REBOOT 的虛擬「0.0.0.0」狀態，例如在未重新啟動的情況下重新啟動更新引擎。
newRequestedPlatformVersion

string

僅供輸出。待處理的更新資訊站應用程式新要求的平台版本。
lastUpdateTime

string (Timestamp format)

僅供輸出。上次成功更新的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastUpdateCheckTime

string (Timestamp format)

僅供輸出。上次更新檢查的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastRebootTime

string (Timestamp format)

僅供輸出。上次重新啟動的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

UpdateState

OS 更新狀態

列舉
UPDATE_STATE_UNSPECIFIED 狀態不明。
OS_IMAGE_DOWNLOAD_NOT_STARTED OS 尚未開始下載。
OS_IMAGE_DOWNLOAD_IN_PROGRESS OS 已開始在裝置上下載。
OS_UPDATE_NEED_REBOOT 裝置必須重新啟動才能完成上傳。

GraphicsInfo

圖形子系統的資訊。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceGraphicsStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_GRAPHICS_INFO
JSON 表示法 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
欄位
adapterInfo

object (GraphicsAdapterInfo)

僅供輸出。顯示卡 (GPU) 相關資訊。
eprivacySupported

boolean

僅供輸出。是否支援電子隱私螢幕。
displayDevices[]

object (DisplayDevice)

僅供輸出。裝置螢幕的相關資訊。
touchScreenInfo

object (TouchScreenInfo)

僅供輸出。裝置內部觸控螢幕的資訊。

GraphicsAdapterInfo

顯示卡 (GPU) 資訊。

JSON 表示法 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
欄位
adapter

string

僅供輸出。轉接程式名稱。例如：Mesa DRI Intel(R) UHD 顯示卡 620 (Kabylake GT2)。
driverVersion

string

僅供輸出。GPU 驅動程式的版本。
deviceId

string (int64 format)

僅供輸出。代表顯示卡裝置 ID。

DisplayDevice

顯示裝置的資訊。

JSON 表示法 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
欄位
displayName

string

僅供輸出。顯示裝置名稱。
displayWidthMm

integer

僅供輸出。螢幕寬度 (以公釐為單位)。
displayHeightMm

integer

僅供輸出。顯示高度 (以公釐為單位)。
internal

boolean

僅供輸出。僅限內部使用。
manufacturerId

string

僅供輸出。由三個字母組成的製造商 ID。
modelId

integer

僅供輸出。製造商產品代碼。
manufactureYear

integer

僅供輸出。製造年份。

TouchScreenInfo

裝置觸控螢幕上的資訊。

JSON 表示法 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
欄位
touchpadLibrary

string

僅供輸出。輸入堆疊使用的觸控板程式庫名稱。
devices[]

object (TouchScreenDevice)

僅供輸出。內部觸控螢幕裝置清單。

TouchScreenDevice

內部觸控螢幕裝置資訊。

JSON 表示法 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
欄位
displayName

string

僅供輸出。觸控螢幕裝置顯示名稱。
touchPointCount

integer

僅供輸出。裝置支援的接觸點數量。
stylusCapable

boolean

僅供輸出。觸控螢幕裝置支援或無法使用觸控筆。

GraphicsStatusReport

圖形子系統的資訊。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceGraphicsInfo
  • 資料收集頻率：3 小時。
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_GRAPHICS_REPORT
JSON 表示法 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
欄位
reportTime

string (Timestamp format)

僅供輸出。影像資料回報的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
displays[]

object (DisplayInfo)

僅供輸出。裝置螢幕的相關資訊。

DisplayInfo

顯示畫面的資訊。

JSON 表示法 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
欄位
deviceId

string (int64 format)

僅供輸出。代表顯示卡裝置 ID。
resolutionWidth

integer

僅供輸出。解析度寬度 (以像素為單位)。
resolutionHeight

integer

僅供輸出。解析度高度 (單位為像素)。
refreshRate

integer

僅供輸出。刷新率 (以 Hz 為單位)。
isInternal

boolean

僅供輸出。表示顯示是否為內部螢幕。
displayName

string

僅供輸出。顯示裝置名稱。

BatteryInfo

電池相關資訊。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過政策控制：ReportDevicePowerStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_BATTERY_INFO
JSON 表示法 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
欄位
serialNumber

string

僅供輸出。電池序號。
manufacturer

string

僅供輸出。電池製造商。
designCapacity

string (int64 format)

僅供輸出。設計容量 (mAmpere 時數)。
designMinVoltage

integer

僅供輸出。設計的最低輸出電壓 (mV)
manufactureDate

object (Date)

僅供輸出。電池製造日期。
technology

string

僅供輸出。電池技術。例如：鋰離子

BatteryStatusReport

電池狀態資料。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDevicePowerStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_BATTERY_REPORT
JSON 表示法 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
欄位
reportTime

string (Timestamp format)

僅供輸出。在裝置上收集樣本的時間戳記

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
serialNumber

string

僅供輸出。電池序號。
sample[]

object (BatterySampleReport)

僅供輸出。電池資料取樣 (依 reportTime 遞減排序)。
batteryHealth

enum (BatteryHealth)

僅供輸出。電池健康度。
fullChargeCapacity

string (int64 format)

僅供輸出。充飽電容量 (mAmpere 時數)。
cycleCount

integer

僅供輸出。週期數。

BatterySampleReport

針對電池取樣資料。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDevicePowerStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
JSON 表示法 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
欄位
reportTime

string (Timestamp format)

僅供輸出。在裝置上收集樣本的時間戳記

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
voltage

string (int64 format)

僅供輸出。電池電壓 (毫電)。
remainingCapacity

string (int64 format)

僅供輸出。電池剩餘電量 (mAmpere 時數)。
temperature

integer

僅供輸出。溫度 (攝氏)。
dischargeRate

integer

僅供輸出。電池放電速率的測量單位為 mW。如果電池正在放電，則為負數；如果正在充電，則為負值。
chargeRate

integer

僅供輸出。電池充電百分比。
current

string (int64 format)

僅供輸出。電池電流 (mA)。
status

string

僅供輸出。從 sysfs 讀取的電池狀態。示例：放電中

BatteryHealth

代表電池的目前健康狀態。

  • 這個狀態並非測量指標，也不是電池有瑕疵。計算方式是將目前的充飽電容量除以設計容量。
  • 電池完整性和保固政策由製造商全權決定。
列舉
BATTERY_HEALTH_UNSPECIFIED 健康狀態不明。
BATTERY_HEALTH_NORMAL 電池健康度良好，充飽電容量 / 設計容量大於 80%
BATTERY_REPLACE_SOON 電池健康度中等，建議盡快更換。充電容量 / 設計容量 75% - 80%
BATTERY_REPLACE_NOW 電池健康狀態不良，建議更換；充電容量 / 設計容量小於 75%

StorageInfo

儲存空間的狀態資料。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控管：ReportDeviceStorageStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_STORAGE_INFO
JSON 表示法 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
欄位
volume[]

object (DiskVolume)

磁碟區相關資訊
availableDiskBytes

string (int64 format)

裝置的可用使用者資料儲存空間 (以位元組為單位)。
totalDiskBytes

string (int64 format)

裝置的使用者資料儲存空間總空間 (以位元組為單位)。

DiskVolume

磁碟區相關資訊

JSON 表示法 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
欄位
volumeId

string

磁碟磁碟區 ID。
storageFreeBytes

string (int64 format)

釋出儲存空間 (以位元組為單位)。
storageTotalBytes

string (int64 format)

儲存空間總量 (以位元組為單位)。

StorageStatusReport

儲存空間的狀態資料。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控管：ReportDeviceStorageStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_STORAGE_REPORT
JSON 表示法 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
欄位
reportTime

string (Timestamp format)

僅供輸出。在裝置上收集樣本的時間戳記

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
disk[]

object (DiskInfo)

僅供輸出。磁碟報告。

DiskInfo

單一儲存裝置的狀態。

JSON 表示法 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
欄位
serialNumber

string

僅供輸出。磁碟序號。
manufacturer

string

僅供輸出。磁碟製造商。
model

string

僅供輸出。磁碟模型
sizeBytes

string (int64 format)

僅供輸出。磁碟大小
type

string

僅供輸出。磁碟類型：eMMC / NVMe / ATA / SCSI。
health

string

僅供輸出。磁碟健康狀態。
volumeIds[]

string

僅供輸出。磁碟磁碟區。
bytesReadThisSession

string (int64 format)

僅供輸出。自上次啟動以來讀取的位元組數。
bytesWrittenThisSession

string (int64 format)

僅供輸出。自上次啟動以來寫入的位元組數。
readTimeThisSession

string (Duration format)

僅供輸出。自上次啟動後從磁碟讀取所花費的時間。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
writeTimeThisSession

string (Duration format)

僅供輸出。自上次啟動後寫入磁碟的時間。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
ioTimeThisSession

string (Duration format)

僅供輸出。計算磁碟和佇列忙碌的時間，因此與上述欄位不同，平行要求不會重複計算。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
discardTimeThisSession

string (Duration format)

僅供輸出。自上次啟動後捨棄的時間。捨棄動作會清除不再使用的區塊。支援核心 4.18 以上版本。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。

ThunderboltInfo

Thunderbolt 公車資訊。

  • 這個欄位提供的裝置資訊是靜態的，不會隨時間改變。
  • 這個欄位的資料是透過政策控管：ReportDeviceSecurityStatus
  • 資料收集頻率：裝置啟動時
  • 預設資料回報頻率：裝置啟動時
    • 政策控制：否
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：是
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_BUS_DEVICE_INFO
JSON 表示法 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
欄位
securityLevel

enum (ThunderboltSecurityLevel)

Thunderbolt 公車的安全等級。

ThunderboltSecurityLevel

Thunderbolt 公車的安全等級。

列舉
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED 未設定 Thunderbolt 安全等級。
THUNDERBOLT_SECURITY_NONE_LEVEL 所有裝置都會自動透過韌體連線。不需使用者核准。
THUNDERBOLT_SECURITY_USER_LEVEL 系統詢問使用者是否能連線至裝置。
THUNDERBOLT_SECURITY_SECURE_LEVEL 系統詢問使用者是否能連線至裝置。此外，根據寫入 Key sysfs 屬性的隨機金鑰，裝置已傳送符合預期的驗證問題
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL 韌體會自動為 Thunderbolt 建立通道。
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL 韌體會自動為 USB 控制器和充電埠中的 Display Port 建立通道。移除座架下游的所有 PCIe 連結。
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL PCIE 通道已停用。

BootPerformanceReport

裝置的啟動效能報告。

  • 這個欄位是遙測資訊，且會隨著使用裝置而改變。
  • 這個欄位的資料是透過政策控制：ReportDeviceBootMode
  • 資料收集頻率：每次啟動事件發生
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：是
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_OS_REPORT
JSON 表示法 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
欄位
bootUpDuration

string (Duration format)

總開機時間。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
bootUpTime

string (Timestamp format)

電源開啟時的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
shutdownDuration

string (Duration format)

關機後經過的總時間。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
shutdownTime

string (Timestamp format)

關機時的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
shutdownReason

enum (ShutdownReason)

關閉原因。
reportTime

string (Timestamp format)

收集報表的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

ShutdownReason

關閉原因。

列舉
SHUTDOWN_REASON_UNSPECIFIED 未指定關閉原因。
USER_REQUEST 使用者啟動。
SYSTEM_UPDATE 系統更新已開始。
LOW_BATTERY 因電量不足而關機。
OTHER 關閉。

HeartbeatStatusReport

裝置的活動訊號狀態報告。

  • 適用於資訊站
  • 這個欄位會顯示裝置的線上/離線/不明狀態，且只有在狀態已變更 (例如「線上」->「離線」) 時才會納入。
  • 這個欄位的資料是透過政策控管：HeartbeatEnabled 更多資訊
  • 活動訊號頻率：2 分鐘
    • 注意：如果裝置未連上網路，系統最多可能需要 12 分鐘才能更新裝置的上線狀態
  • 快取：如果裝置處於離線狀態，收集到的資料會儲存在本機，並在裝置下次連上網路時回報：不適用
  • 僅回報關聯使用者的數據：不適用
  • 需要精細權限：TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON 表示法 
{
  "reportTime": string,
  "state": enum (State)
}
欄位
reportTime

string (Timestamp format)

偵測到狀態變更的時間戳記

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
state

enum (State)

裝置的狀態已變更

狀態

裝置狀態

列舉
STATE_UNSPECIFIED 未指定狀態
UNKNOWN 裝置不符合心率監控功能的條件
ONLINE 裝置已連上網路
OFFLINE 裝置處於離線狀態

KioskAppStatusReport

裝置的資訊站應用程式狀態報告。

  • 適用於資訊站
  • 這個欄位提供在資訊站裝置上執行的應用程式 ID 和版本號碼，以及報告上次更新時的時間戳記
  • 這個欄位的資料是透過政策控制：ReportDeviceSessionStatus
  • 資料收集頻率：只在上傳時
  • 預設資料報表頻率：3 小時
    • 政策受到控制：是
  • 快取：如果裝置處於離線狀態，系統會將收集到的資料儲存在本機，並在裝置下次連上網路時回報：否
  • 僅回報關聯使用者的數據：不適用
  • 需要精細的權限：TELEMETRY_API_APPS_REPORT
JSON 表示法 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
欄位
reportTime

string (Timestamp format)

收集報表的時間戳記

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
appId

string

資訊站應用程式的應用程式 ID，例如「mdmkkicfmmkgmpkmkdikhlbggogpicma」
appVersion

string

資訊站應用程式的應用程式版本編號，例如「1.10.118」

RuntimeCountersReport

從 CPU 擷取到的執行階段計數器。目前只有 Intel vPro PSR 在 14 以上版本中支援執行階段計數器遙測功能。

JSON 表示法 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
欄位
reportTime

string (Timestamp format)

收集報表的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
uptimeRuntimeDuration

string (Duration format)

生命週期總執行階段。目前一律從 Intel vPro PSR 執行 S0 執行階段。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「s」。例如："3.5s"。
enterSleepCount

string (int64 format)

裝置進入睡眠狀態的次數。目前是透過 PSR 取得，計數從 S0 到 S3。
enterHibernationCount

string (int64 format)

裝置進入休眠狀態的次數。目前是透過 PSR 取得，計數從 S0 到 S4。
enterPoweroffCount

string (int64 format)

裝置進入關機狀態的次數。目前是透過 PSR 取得，計數從 S0 到 S5。

方法

get

 取得遙測裝置。

list

 列出所有遙測裝置。