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)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
欄位
name

string

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

string

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

string

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

string

僅供輸出。裝置的專屬 Directory API ID。這個值與管理控制台「ChromeOS 裝置」分頁中的「目錄 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 遞減排序。
appReport[]

object (AppReport)

僅供輸出。定期收集的應用程式報表，以 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

僅供輸出。是否已設定 Key Locker。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 標籤。範例：Core 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」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "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

僅供輸出。網路連線 GUID。
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」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "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)

僅供輸出。設計容量 (mA 小時)。
designMinVoltage

integer

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

object (Date)

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

string

僅供輸出。電池技術。範例：Li-ion

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」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "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-hours)。
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」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
voltage

string (int64 format)

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

string (int64 format)

僅供輸出。電池剩餘容量 (mA 小時)。
temperature

integer

僅供輸出。溫度單位為攝氏。
dischargeRate

integer

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

integer

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

string (int64 format)

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

string

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

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」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "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 系統會詢問使用者是否允許連線裝置。此外，該裝置還收到一項驗證要求，此挑戰是根據寫入金鑰 sysfs 屬性的隨機金鑰而定
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL 韌體會自動為 Thunderbolt 建立通道。
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL 韌體會自動為 USB 控制器和基座中的 DisplayPort 建立通道。移除了座架的所有 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」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "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

裝置的訊號報告。

  • 適用於 Kiosk
  • 這個欄位提供裝置的線上/離線/不明狀態，只有狀態變更才會納入 (例如「線上」->「離線」)。
  • 這個欄位的資料會透過政策控管：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

裝置的 Kiosk 應用程式狀態報告。

  • 適用於 Kiosk
  • 這個欄位會提供資訊站裝置執行的應用程式 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 第 14 代以上版本的 PSR 支援執行階段計數器遙測功能。

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

 列出所有遙測裝置。