- 资源:TelemetryEvent
- TelemetryDeviceInfo
- TelemetryUserInfo
- TelemetryAudioSevereUnderrunEvent
- TelemetryUsbPeripheralsEvent
- TelemetryNetworkConnectionStateChangeEvent
- TelemetryHttpsLatencyChangeEvent
- HttpsLatencyState
- TelemetryNetworkSignalStrengthEvent
- TelemetryAppInstallEvent
- ApplicationInstallSource
- ApplicationInstallReason
- ApplicationInstallTime
- TelemetryAppUninstallEvent
- ApplicationUninstallSource
- TelemetryAppLaunchEvent
- ApplicationLaunchSource
- 方法
资源:TelemetryEvent
受管设备报告的遥测数据。
JSON 表示法 |
---|
{ "name": string, "device": { object ( |
字段 | |
---|---|
name |
仅限输出。事件的资源名称。 |
device |
仅限输出。与事件关联的设备的相关信息。 |
user |
仅限输出。与事件关联的用户的相关信息。 |
reportTime |
表示事件报告时间的时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
eventType |
当前事件的事件类型。 |
audioSevereUnderrunEvent |
仅限输出。音频严重欠载事件的载荷。仅当 |
usbPeripheralsEvent |
仅限输出。USB 外围设备事件的载荷。仅当 |
networkStateChangeEvent |
仅限输出。网络连接状态更改事件的载荷。仅当 |
httpsLatencyChangeEvent |
仅限输出。HTTPS 延迟时间变化事件的载荷。仅当 |
wifiSignalStrengthEvent |
仅限输出。Wi-Fi 信号强度事件的载荷。仅当 |
vpnConnectionStateChangeEvent |
仅限输出。VPN 连接状态更改事件的载荷。仅当 |
appInstallEvent |
仅限输出。应用安装事件的载荷。仅当 |
appUninstallEvent |
仅限输出。应用卸载事件的载荷。仅当 |
appLaunchEvent |
仅限输出。应用启动 event. 的载荷。仅当 |
TelemetryDeviceInfo
与遥测数据关联的设备的相关信息。
- 需要的细化权限:TELEMETRY_API_DEVICE
JSON 表示法 |
---|
{ "deviceId": string, "orgUnitId": string } |
字段 | |
---|---|
deviceId |
仅限输出。设备的唯一 Directory API ID。此值与管理控制台的“ChromeOS 设备”标签页中的 Directory API ID 相同。 |
orgUnitId |
仅限输出。设备的组织部门 ID。 |
TelemetryUserInfo
与遥测数据关联的用户的相关信息。
- 需要细化权限:TELEMETRY_API_USER
JSON 表示法 |
---|
{ "email": string, "orgUnitId": string } |
字段 | |
---|---|
email |
仅限输出。用户的电子邮件地址。 |
orgUnitId |
仅限输出。用户的组织部门 ID。 |
TelemetryAudioSevereUnderrunEvent
此类型没有字段。
当音频设备的缓冲区数据耗尽时间超过 5 秒时,就会触发 TelemetryAudioSevereUnderrunEvent
。
- 需要细化权限:TELEMETRY_API_AUDIO_REPORT
TelemetryUsbPeripheralsEvent
被触发 TelemetryUsbPeripheralsEvent
时,系统会添加或移除 USB 设备。
- 需要细化权限:TELEMETRY_API_PERIPHERALS_REPORT
JSON 表示法 |
---|
{
"usbPeripheralReport": [
{
object ( |
字段 | |
---|---|
usbPeripheralReport[] |
添加或移除的 USB 设备的列表。 |
TelemetryNetworkConnectionStateChangeEvent
TelemetryNetworkConnectionStateChangeEvent
在网络连接状态发生变化时触发。
- 需要细化权限:TELEMETRY_API_NETWORK_REPORT
JSON 表示法 |
---|
{
"guid": string,
"connectionState": enum ( |
字段 | |
---|---|
guid |
网络的唯一标识符。 |
connectionState |
网络的当前连接状态。 |
TelemetryHttpsLatencyChangeEvent
HTTP 延迟例程会定期运行,如果检测到延迟问题或设备已从延迟问题中恢复,就会触发 TelemetryHttpsLatencyChangeEvent
。
- 需要细化权限:TELEMETRY_API_NETWORK_REPORT
JSON 表示法 |
---|
{ "httpsLatencyRoutineData": { object ( |
字段 | |
---|---|
httpsLatencyRoutineData |
触发事件的 HTTPS 延迟时间例程数据。 |
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 |
网络的唯一标识符。 |
signalStrengthDbm |
信号强度 RSSI 值。 |
TelemetryAppInstallEvent
应用安装数据。
JSON 表示法 |
---|
{ "appInstallSource": enum ( |
字段 | |
---|---|
appInstallSource |
应用安装来源。 |
appInstallReason |
应用安装原因。 |
appInstallTime |
应用安装时间取决于应用生命周期。 |
appId |
应用 ID。对于 PWA,这是起始网址;对于扩展程序,则是扩展程序 ID。 |
appType |
应用的类型。 |
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 ( |
字段 | |
---|---|
appUninstallSource |
应用卸载来源。 |
appId |
应用 ID。对于 PWA,这是起始网址;对于扩展程序,则是扩展程序 ID。 |
appType |
应用的类型。 |
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 ( |
字段 | |
---|---|
appLaunchSource |
应用启动来源。 |
appId |
应用 ID。对于 PWA,这是起始网址;对于扩展程序,则是扩展程序 ID。 |
appType |
应用的类型。 |
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_LINK |
在浏览器中点击某个链接后,可启动应用。 |
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 |
已从焦点面板启动应用。 |
方法 |
|
---|---|
|
列出遥测事件。 |