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)
  }
}
字段
name

string

仅限输出。事件的资源名称。

device

object (TelemetryDeviceInfo)

仅限输出。与事件关联的设备的相关信息。

user

object (TelemetryUserInfo)

仅限输出。与事件关联的用户的相关信息。

reportTime

string (Timestamp format)

表示事件报告时间的时间戳。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"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_ADDEDUSB_REMOVED 时存在。

networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

仅限输出。网络连接状态更改事件的载荷。仅当 eventTypeNETWORK_STATE_CHANGE 时存在。

httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

仅限输出。HTTPS 延迟时间变化事件的载荷。仅当 eventTypeNETWORK_HTTPS_LATENCY_CHANGE 时存在。

wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

仅限输出。Wi-Fi 信号强度事件的载荷。仅当 eventTypeWIFI_SIGNAL_STRENGTH_LOWWIFI_SIGNAL_STRENGTH_RECOVERED 时存在。

vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

仅限输出。VPN 连接状态更改事件的载荷。仅当 eventTypeVPN_CONNECTION_STATE_CHANGE 时存在。

appInstallEvent

object (TelemetryAppInstallEvent)

仅限输出。应用安装事件的载荷。仅当 eventTypeAPP_INSTALLED 时存在。

appUninstallEvent

object (TelemetryAppUninstallEvent)

仅限输出。应用卸载事件的载荷。仅当 eventTypeAPP_UNINSTALLED 时存在。

appLaunchEvent

object (TelemetryAppLaunchEvent)

仅限输出。应用启动 event. 的载荷。仅当 eventTypeAPP_LAUNCHED 时存在。

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

网络的唯一标识符。

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

网络的唯一标识符。

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 作为 Chrome 操作系统的一部分安装的应用。
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 应用已安装 bt SubApp API 调用。
APPLICATION_INSTALL_REASON_KIOSK 通过 Chrome 操作系统上的自助服务终端安装的应用。
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 从 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 从 intent 网址启动的应用。
APPLICATION_LAUNCH_SOURCE_OS_LOGIN 已通过 OS Login 启动应用。
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 WebUI 的个人资料菜单启动。
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 已从焦点面板启动应用。

方法

list

列出遥测事件。