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)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
欄位
name

string

僅供輸出。活動的資源名稱。
device

object (TelemetryDeviceInfo)

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

object (TelemetryUserInfo)

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

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 時，這項屬性才會存在。
appInstallEvent

object (TelemetryAppInstallEvent)

僅供輸出。應用程式安裝事件的酬載。只有在 eventType 為 APP_INSTALLED 時，這項屬性才會存在。
appUninstallEvent

object (TelemetryAppUninstallEvent)

僅供輸出。應用程式解除安裝事件的酬載。只有在 eventType 為 APP_UNINSTALLED 時，這項屬性才會存在。
appLaunchEvent

object (TelemetryAppLaunchEvent)

僅供輸出。應用程式啟動事件的酬載。只有在 eventType 為 APP_LAUNCHED 時才會顯示。
osCrashEvent

object (TelemetryOsCrashEvent)

僅供輸出。OS 當機事件的酬載。只有在 eventType 為 OS_CRASH 時，這項屬性才會存在。
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

僅供輸出。外接螢幕連線/中斷連線事件的酬載。只有在 eventType 為 EXTERNAL_DISPLAY_CONNECTED 或 EXTERNAL_DISPLAY_DISCONNECTED 時，才顯示此屬性。

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

系統會定期執行 Https 延遲常式，並在偵測到延遲問題或裝置已從延遲問題中恢復時觸發 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 值。

TelemetryAppInstallEvent

應用程式安裝資料。

JSON 表示法 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
欄位
appInstallSource

enum (ApplicationInstallSource)

應用程式安裝來源。
appInstallReason

enum (ApplicationInstallReason)

應用程式安裝原因。
appInstallTime

enum (ApplicationInstallTime)

應用程式安裝時間取決於應用程式生命週期。
appId

string

應用程式 ID。如果是 PWA，這是啟動網址；如果是擴充功能，這是擴充功能 ID。
appType

enum (TelemetryApplicationType)

應用程式類型。

ApplicationInstallSource

說明應用程式的安裝來源。

列舉
APPLICATION_INSTALL_SOURCE_UNSPECIFIED 應用程式安裝來源不明。
APPLICATION_INSTALL_SOURCE_SYSTEM 隨 ChromeOS 安裝的應用程式。
APPLICATION_INSTALL_SOURCE_SYNC 應用程式安裝來源為同步。
APPLICATION_INSTALL_SOURCE_PLAY_STORE 應用程式安裝來源為 Play 商店。
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE 應用程式安裝來源為 Chrome 線上應用程式商店。
APPLICATION_INSTALL_SOURCE_BROWSER 應用程式安裝來源是瀏覽器。

ApplicationInstallReason

說明應用程式的安裝原因。

列舉
APPLICATION_INSTALL_REASON_UNSPECIFIED 應用程式安裝原因不明。
APPLICATION_INSTALL_REASON_SYSTEM 隨系統安裝的應用程式，視為作業系統的一部分。
APPLICATION_INSTALL_REASON_POLICY 應用程式是依據政策安裝。
APPLICATION_INSTALL_REASON_OEM 原始設備製造商 (OEM) 安裝的應用程式。
APPLICATION_INSTALL_REASON_DEFAULT 預設安裝的應用程式，但不屬於系統應用程式。
APPLICATION_INSTALL_REASON_SYNC 透過同步安裝的應用程式。
APPLICATION_INSTALL_REASON_USER 使用者操作安裝的應用程式。
APPLICATION_INSTALL_REASON_SUB_APP 透過 SubApp API 呼叫安裝的應用程式。
APPLICATION_INSTALL_REASON_KIOSK 由 ChromeOS 資訊站安裝的應用程式。
APPLICATION_INSTALL_REASON_COMMAND_LINE 透過指令列引數安裝的應用程式。

ApplicationInstallTime

說明應用程式安裝時間 (視應用程式生命週期而定)。

列舉
APPLICATION_INSTALL_TIME_UNSPECIFIED 應用程式安裝時間不明。
APPLICATION_INSTALL_TIME_INIT 應用程式安裝作業已初始化。
APPLICATION_INSTALL_TIME_RUNNING 目前正在安裝應用程式。

TelemetryAppUninstallEvent

應用程式解除安裝資料。

JSON 表示法 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
欄位
appUninstallSource

enum (ApplicationUninstallSource)

應用程式解除安裝來源。
appId

string

應用程式 ID。如果是 PWA，這是啟動網址；如果是擴充功能，這是擴充功能 ID。
appType

enum (TelemetryApplicationType)

應用程式類型。

ApplicationUninstallSource

說明應用程式解除安裝來源。

列舉
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED 應用程式解除安裝來源不明。
APPLICATION_UNINSTALL_SOURCE_APP_LIST 從應用程式清單 (啟動器) 解除安裝應用程式。
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT 從「應用程式管理」頁面解除安裝應用程式。
APPLICATION_UNINSTALL_SOURCE_SHELF 應用程式已從檔案櫃解除安裝。
APPLICATION_UNINSTALL_SOURCE_MIGRATION 應用程式已透過應用程式遷移功能解除安裝。

TelemetryAppLaunchEvent

應用程式啟動資料。

JSON 表示法 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
欄位
appLaunchSource

enum (ApplicationLaunchSource)

應用程式啟動來源。
appId

string

應用程式 ID。如果是 PWA，這是啟動網址；如果是擴充功能，這是擴充功能 ID。
appType

enum (TelemetryApplicationType)

應用程式類型。

ApplicationLaunchSource

說明應用程式啟動來源。

列舉
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED 應用程式啟動來源不明。
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID 從應用程式格線啟動應用程式，而非搜尋框。
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU 從應用程式格線啟動應用程式，而非從內容選單啟動。
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY 從與查詢相關的結果啟動應用程式 (較大的圖示)。
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU 從內容選單啟動應用程式，並從查詢相關結果啟動。
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION 從沒有查詢的建議啟動應用程式 (較小的圖示)。
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS 從「家長監護設定」部分啟動應用程式，以及每個應用程式的時間通知。
APPLICATION_LAUNCH_SOURCE_SHELF 從檔案櫃啟動應用程式。
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER 從檔案管理員啟動應用程式
APPLICATION_LAUNCH_SOURCE_OMNIBOX 從瀏覽器的網址列輸入網址啟動應用程式。
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL 透過 Chrome 內部呼叫啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_KEYBOARD 透過鍵盤快速鍵啟動應用程式。
APPLICATION_LAUNCH_SOURCE_OTHER_APP 從其他應用程式或 WebUI 中點選連結啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_MENU 從選單啟動應用程式。
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION 從已安裝的通知啟動應用程式。
APPLICATION_LAUNCH_SOURCE_TEST 從測試啟動應用程式。
APPLICATION_LAUNCH_SOURCE_ARC 從 Arc 啟動應用程式。
APPLICATION_LAUNCH_SOURCE_SHARESHEET 從分享功能啟動應用程式。
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION 從版本資訊通知啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE 從完整還原作業啟動應用程式。
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU 從智慧文字選取內容選單啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION 應用程式是從「探索」分頁通知啟動。
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API 透過 Management API 啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_KIOSK 從資訊站啟動應用程式。
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE 從指令列啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE 從背景模式啟動應用程式。
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE 從新分頁啟動應用程式。
APPLICATION_LAUNCH_SOURCE_INTENT_URL 透過意圖網址啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_OS_LOGIN 應用程式是透過 OS 登入啟動。
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER 透過通訊協定處理常式啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_URL_HANDLER 透過網址處理常式啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN 從螢幕鎖定畫面應用程式啟動器啟動應用程式。
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE 從應用程式首頁 (chrome://apps) 啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_REPARENTING 從將內容移至應用程式啟動應用程式。
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU 從可安裝的 chrome://password-manager 網頁使用者介面的設定檔選單啟動應用程式。
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR 從系統匣日曆啟動應用程式。
APPLICATION_LAUNCH_SOURCE_INSTALLER 從來源安裝程式啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_FIRST_RUN 我們將首次啟動「說明」應用程式的次數分開計算，以便瞭解使用者觸發啟動的次數。
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR 從歡迎導覽啟動應用程式。
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE 從焦點面板啟動應用程式。
APPLICATION_LAUNCH_SOURCE_SPARKY 透過實驗功能 Sparky 啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING 從導覽擷取畫面啟動的應用程式。
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API 透過網路安裝 API 啟動的應用程式。

TelemetryOsCrashEvent

OS 當機資料。

JSON 表示法 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
欄位
crashType

enum (CrashType)

事故類型。
sessionType

enum (SessionType)

工作階段類型。
crashId

string

當機 ID。

CrashType

說明當機類型。

列舉
CRASH_TYPE_UNSPECIFIED 當機類型不明。
CRASH_TYPE_KERNEL 核心當機。
CRASH_TYPE_EMBEDDED_CONTROLLER 嵌入式控制器當機。

SessionType

說明工作階段類型。

列舉
SESSION_TYPE_UNSPECIFIED 工作階段類型不明。
SESSION_TYPE_SIGNED_IN_USER 已登入的使用者。
SESSION_TYPE_KIOSK 資訊站：
SESSION_TYPE_MANAGED_GUEST 受管理的訪客工作階段。
SESSION_TYPE_ACTIVE_DIRECTORY Active Directory 工作階段。

TelemetryExternalDisplayEvent

外接螢幕連線/中斷連線事件的酬載。

JSON 表示法 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
欄位
externalDisplayData[]

object (TelemetryExternalDisplayData)

已連線/中斷連線的外接螢幕清單。

TelemetryExternalDisplayData

外部螢幕資料。

JSON 表示法 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
欄位
displayName

string

顯示名稱。
resolutionHorizontal

integer

水平解析度。
resolutionVertical

integer

垂直解析度。
refreshRate

string (int64 format)

刷新率。
serialNumber

integer

序號。
edidVersion

string

EDID 版本。

方法

list

 列出遙測事件。