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 规范化（即转换为 UTC 零时区格式并在末尾附加 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)

仅限输出。操作系统崩溃事件的载荷。仅当 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

当添加或移除 USB 设备时，系统会触发 TelemetryUsbPeripheralsEvent。

  • 所需精细化权限：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

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

网络的唯一标识符。
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 通过 SubApp API 调用安装的应用。
APPLICATION_INSTALL_REASON_KIOSK 由自助服务终端在 Chrome OS 上安装的应用。
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 应用已从 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 通过在浏览器中的 Omnibox 中输入网址启动的应用。
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL 通过 Chrome 内部调用启动的应用。
APPLICATION_LAUNCH_SOURCE_KEYBOARD 通过用于打开应用的键盘快捷键启动的应用。
APPLICATION_LAUNCH_SOURCE_OTHER_APP 通过点击其他应用或 Web 界面中的链接启动的应用。
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 通过 intent 网址启动的应用。
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 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 从焦点面板启动的应用。
APPLICATION_LAUNCH_SOURCE_SPARKY 通过实验性功能 Sparky 启动的应用。
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING 从导航捕获启动的应用。
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API 通过 Web 安装 API 启动的应用。

TelemetryOsCrashEvent

操作系统崩溃数据。

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

 列出遥测事件。