REST Resource: customers.telemetry.events

資源：TelemetryEvent

受管理裝置回報的遙測資料。

JSON 表示法 
{
  "name": string,
  "device": {
    object (TelemetryDeviceInfo)
  },
  "user": {
    object (TelemetryUserInfo)
  },
  "reportTime": string,
  "eventType": enum (EventType),
  "audioSevereUnderrunEvent": {
    object (TelemetryAudioSevereUnderrunEvent)
  },
  "usbPeripheralsEvent": {
    object (TelemetryUsbPeripheralsEvent)
  },
  "networkStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "httpsLatencyChangeEvent": {
    object (TelemetryHttpsLatencyChangeEvent)
  },
  "wifiSignalStrengthEvent": {
    object (TelemetryNetworkSignalStrengthEvent)
  },
  "vpnConnectionStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  }
}
欄位
name

string

僅供輸出。事件的資源名稱。
device

object (TelemetryDeviceInfo)

僅供輸出。與事件相關聯的裝置相關資訊。
user

object (TelemetryUserInfo)

僅供輸出。與事件相關聯的使用者相關資訊。
reportTime

string (Timestamp format)

時間戳記，代表事件回報時間。

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

enum (EventType)

目前事件的事件類型。
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

僅供輸出。音訊嚴重低跑事件的酬載。只有在 eventType 欄位為 AUDIO_SEVERE_UNDERRUN 時才會顯示。
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

僅供輸出。USB 週邊裝置事件酬載。只有在 eventType 欄位為 USB_ADDED 或 USB_REMOVED 時才會顯示。
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

僅供輸出。網路連線狀態變更事件的酬載。只有在eventType是 NETWORK_STATE_CHANGE 時才會顯示。
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

僅供輸出。HTTPS 延遲變更事件的酬載。只有在eventType是 NETWORK_HTTPS_LATENCY_CHANGE 時才會顯示。
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

僅供輸出。Wi-Fi 訊號強度事件酬載。只會在 eventType 為 WIFI_SIGNAL_STRENGTH_LOW 或 WIFI_SIGNAL_STRENGTH_RECOVERED 時顯示。
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

僅供輸出。VPN 連線狀態變更事件的酬載。只有在eventType是 VPN_CONNECTION_STATE_CHANGE 時才會顯示。

TelemetryDeviceInfo

與遙測資料相關聯的裝置相關資訊。

  • 需要精細權限：TELEMETRY_API_DEVICE
JSON 表示法 
{
  "deviceId": string,
  "orgUnitId": string
}
欄位
deviceId

string

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

string

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

TelemetryUserInfo

與遙測資料相關聯的使用者資訊。

  • 需要精細權限：TELEMETRY_API_USER
JSON 表示法 
{
  "email": string,
  "orgUnitId": string
}
欄位
email

string

僅供輸出。使用者的電子郵件。
orgUnitId

string

僅供輸出。使用者的機構單位 ID。

TelemetryAudioSevereUnderrunEvent

這個類型沒有任何欄位。

如果音訊裝置用盡緩衝區資料超過 5 秒，就會觸發 TelemetryAudioSevereUnderrunEvent。

  • 需要精細的權限：TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

「TelemetryUsbPeripheralsEvent」觸發的 USB 裝置會遭到新增或移除。

  • 需要精細的權限：TELEMETRY_API_PERIPHERALS_REPORT
JSON 表示法 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
欄位
usbPeripheralReport[]

object (UsbPeripheralReport)

新增或移除的 USB 裝置清單。

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent 會在網路連線狀態變更時觸發。

  • 需要精細的權限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
欄位
guid

string

網路的專屬 ID。
connectionState

enum (NetworkConnectionState)

網路目前的連線狀態。

TelemetryHttpsLatencyChangeEvent

系統會定期執行 HTTP 延遲處理常式，如果偵測到延遲問題，或裝置從延遲問題復原，就會觸發 TelemetryHttpsLatencyChangeEvent。

  • 需要精細的權限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
欄位
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

觸發事件的 HTTPS 延遲處理常式資料。
httpsLatencyState

enum (HttpsLatencyState)

目前的 HTTPS 延遲狀態。

HttpsLatencyState

HTTPS 延遲狀態。

列舉
HTTPS_LATENCY_STATE_UNSPECIFIED 未指定 HTTPS 延遲狀態。
RECOVERY 從問題復原的 HTTPS 延遲。
PROBLEM HTTPS 延遲問題。

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent 會在 Wi-Fi 訊號強度事件時觸發。

  • 需要精細的權限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "guid": string,
  "signalStrengthDbm": integer
}
欄位
guid

string

網路的專屬 ID。
signalStrengthDbm

integer

訊號強度 RSSI 值。

方法

list

 列出遙測事件。