REST Resource: customers.telemetry.events

Tài nguyên: TelemetryEvent

Dữ liệu đo từ xa do thiết bị được quản lý báo cáo.

Biểu diễn dưới dạng 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)
  }
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của sự kiện.
device

object (TelemetryDeviceInfo)

Chỉ có đầu ra. Thông tin về thiết bị liên kết với sự kiện.
user

object (TelemetryUserInfo)

Chỉ có đầu ra. Thông tin về người dùng được liên kết với sự kiện.
reportTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm sự kiện được báo cáo.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

Loại sự kiện của sự kiện hiện tại.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện âm thanh bị thiếu nghiêm trọng. Chỉ xuất hiện khi trường eventType là AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện thiết bị ngoại vi USB. Chỉ xuất hiện khi trường eventType là USB_ADDED hoặc USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện thay đổi trạng thái kết nối mạng. Chỉ xuất hiện khi eventType là NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện thay đổi độ trễ HTTPS. Chỉ xuất hiện khi eventType là NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Chỉ có đầu ra. Trọng tải cho các sự kiện cường độ tín hiệu Wi-Fi. Chỉ xuất hiện khi eventType là WIFI_SIGNAL_STRENGTH_LOW hoặc WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện thay đổi trạng thái kết nối VPN. Chỉ xuất hiện khi eventType là VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện cài đặt ứng dụng. Chỉ xuất hiện khi eventType là APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện gỡ cài đặt ứng dụng. Chỉ xuất hiện khi eventType là APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện khởi chạy ứng dụng.Chỉ xuất hiện khi eventType là APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Chỉ có đầu ra. Trọng tải cho sự kiện sự cố hệ điều hành. Chỉ xuất hiện khi eventType là OS_CRASH.

TelemetryDeviceInfo

Thông tin về một thiết bị được liên kết với dữ liệu đo từ xa.

  • Cần có Quyền chi tiết: TELEMETRY_API_DEVICE
Biểu diễn dưới dạng JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
Trường
deviceId

string

Chỉ có đầu ra. Mã Directory API duy nhất của thiết bị. Giá trị này giống với mã Directory API của Bảng điều khiển dành cho quản trị viên trong thẻ Thiết bị ChromeOS.
orgUnitId

string

Chỉ có đầu ra. Mã nhận dạng đơn vị tổ chức của thiết bị.

TelemetryUserInfo

Thông tin về người dùng được liên kết với dữ liệu đo từ xa.

  • Cần có quyền chi tiết: TELEMETRY_API_USER
Biểu diễn dưới dạng JSON 
{
  "email": string,
  "orgUnitId": string
}
Trường
email

string

Chỉ có đầu ra. Email của người dùng.
orgUnitId

string

Chỉ có đầu ra. Mã đơn vị tổ chức của người dùng.

TelemetryAudioSevereUnderrunEvent

Loại này không có trường nào.

TelemetryAudioSevereUnderrunEvent được kích hoạt khi thiết bị âm thanh hết dữ liệu vùng đệm trong hơn 5 giây.

  • Cần có quyền chi tiết: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent được kích hoạt khi thiết bị USB được thêm hoặc xoá.

  • Cần có quyền chi tiết: TELEMETRY_API_PERIPHERALS_REPORT
Biểu diễn dưới dạng JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Trường
usbPeripheralReport[]

object (UsbPeripheralReport)

Danh sách thiết bị USB đã được thêm hoặc xoá.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent được kích hoạt khi trạng thái kết nối mạng thay đổi.

  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Trường
guid

string

Giá trị nhận dạng duy nhất của mạng.
connectionState

enum (NetworkConnectionState)

Trạng thái kết nối hiện tại của mạng.

TelemetryHttpsLatencyChangeEvent

Quy trình độ trễ https được chạy định kỳ và TelemetryHttpsLatencyChangeEvent được kích hoạt nếu phát hiện thấy vấn đề về độ trễ hoặc nếu thiết bị đã khôi phục sau vấn đề về độ trễ.

  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Trường
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Dữ liệu định kỳ về độ trễ HTTPS đã kích hoạt sự kiện.
httpsLatencyState

enum (HttpsLatencyState)

Trạng thái độ trễ HTTPS hiện tại.

HttpsLatencyState

Trạng thái độ trễ HTTPS.

Enum
HTTPS_LATENCY_STATE_UNSPECIFIED Trạng thái độ trễ HTTPS chưa được chỉ định.
RECOVERY Độ trễ HTTPS đã được khắc phục sau khi gặp vấn đề.
PROBLEM Vấn đề về độ trễ HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent được kích hoạt trên các sự kiện cường độ tín hiệu Wi-Fi.

  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Trường
guid

string

Giá trị nhận dạng duy nhất của mạng.
signalStrengthDbm

integer

Giá trị RSSI của cường độ tín hiệu.

TelemetryAppInstallEvent

Dữ liệu về lượt cài đặt ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Trường
appInstallSource

enum (ApplicationInstallSource)

Nguồn cài đặt ứng dụng.
appInstallReason

enum (ApplicationInstallReason)

Lý do cài đặt ứng dụng.
appInstallTime

enum (ApplicationInstallTime)

Thời gian cài đặt ứng dụng tuỳ thuộc vào vòng đời của ứng dụng.
appId

string

Mã ứng dụng. Đối với PWA, đây là URL bắt đầu và đối với tiện ích, đây là mã nhận dạng tiện ích.
appType

enum (TelemetryApplicationType)

Loại ứng dụng.

ApplicationInstallSource

Mô tả nguồn cài đặt ứng dụng.

Enum
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Không xác định được nguồn cài đặt ứng dụng.
APPLICATION_INSTALL_SOURCE_SYSTEM Ứng dụng được cài đặt trong Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC Nguồn cài đặt ứng dụng là một quá trình đồng bộ hoá.
APPLICATION_INSTALL_SOURCE_PLAY_STORE Nguồn cài đặt ứng dụng là Cửa hàng Play.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE Nguồn cài đặt ứng dụng là Cửa hàng Chrome trực tuyến.
APPLICATION_INSTALL_SOURCE_BROWSER Nguồn cài đặt ứng dụng là trình duyệt.

ApplicationInstallReason

Mô tả lý do cài đặt ứng dụng.

Enum
APPLICATION_INSTALL_REASON_UNSPECIFIED Không xác định được lý do cài đặt ứng dụng.
APPLICATION_INSTALL_REASON_SYSTEM Ứng dụng được cài đặt cùng với hệ thống và được coi là một phần của hệ điều hành.
APPLICATION_INSTALL_REASON_POLICY Ứng dụng được cài đặt theo chính sách.
APPLICATION_INSTALL_REASON_OEM Ứng dụng do nhà sản xuất thiết bị gốc (OEM) cài đặt.
APPLICATION_INSTALL_REASON_DEFAULT Ứng dụng được cài đặt theo mặc định nhưng không được coi là ứng dụng hệ thống.
APPLICATION_INSTALL_REASON_SYNC Ứng dụng được cài đặt bằng tính năng đồng bộ hoá.
APPLICATION_INSTALL_REASON_USER Ứng dụng được cài đặt theo hành động của người dùng.
APPLICATION_INSTALL_REASON_SUB_APP Lệnh gọi API SubApp bt được cài đặt ứng dụng.
APPLICATION_INSTALL_REASON_KIOSK Ứng dụng do Kiosk cài đặt trên Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Ứng dụng được cài đặt bằng đối số dòng lệnh.

ApplicationInstallTime

Mô tả thời gian cài đặt ứng dụng tuỳ thuộc vào vòng đời của ứng dụng.

Enum
APPLICATION_INSTALL_TIME_UNSPECIFIED Không xác định được thời gian cài đặt ứng dụng.
APPLICATION_INSTALL_TIME_INIT Quá trình cài đặt ứng dụng được khởi tạo.
APPLICATION_INSTALL_TIME_RUNNING Quá trình cài đặt ứng dụng đang chạy.

TelemetryAppUninstallEvent

Dữ liệu về lượt gỡ cài đặt ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Trường
appUninstallSource

enum (ApplicationUninstallSource)

Nguồn gỡ cài đặt ứng dụng.
appId

string

Mã ứng dụng. Đối với PWA, đây là URL bắt đầu và đối với tiện ích, đây là mã nhận dạng tiện ích.
appType

enum (TelemetryApplicationType)

Loại ứng dụng.

ApplicationUninstallSource

Mô tả nguồn gỡ cài đặt ứng dụng.

Enum
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Không xác định được nguồn gỡ cài đặt ứng dụng.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Ứng dụng đã bị gỡ cài đặt khỏi Danh sách ứng dụng (Trình chạy).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Ứng dụng đã được gỡ cài đặt khỏi trang Quản lý ứng dụng.
APPLICATION_UNINSTALL_SOURCE_SHELF Ứng dụng đã bị gỡ cài đặt khỏi Kệ.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Ứng dụng đã bị gỡ cài đặt do quá trình di chuyển ứng dụng.

TelemetryAppLaunchEvent

Dữ liệu khởi chạy ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Trường
appLaunchSource

enum (ApplicationLaunchSource)

Nguồn khởi chạy ứng dụng.
appId

string

Mã ứng dụng. Đối với PWA, đây là URL bắt đầu và đối với tiện ích, đây là mã nhận dạng tiện ích.
appType

enum (TelemetryApplicationType)

Loại ứng dụng.

ApplicationLaunchSource

Mô tả nguồn khởi chạy ứng dụng.

Enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Không xác định được nguồn khởi chạy ứng dụng.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Ứng dụng được chạy từ lưới ứng dụng, chứ không phải hộp tìm kiếm.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Ứng dụng được chạy từ lưới ứng dụng, ngoài trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Ứng dụng được chạy từ kết quả phụ thuộc vào truy vấn (biểu tượng lớn hơn).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Ứng dụng được chạy từ kết quả phụ thuộc vào truy vấn, ngoài trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Ứng dụng được chạy từ các đề xuất không có truy vấn (biểu tượng nhỏ hơn).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Ứng dụng được chạy từ phần Cài đặt kiểm soát của cha mẹ và thông báo Thời gian cho mỗi ứng dụng.
APPLICATION_LAUNCH_SOURCE_SHELF Ứng dụng được chạy từ kệ.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Ứng dụng được chạy từ trình quản lý tệp
APPLICATION_LAUNCH_SOURCE_OMNIBOX Ứng dụng được chạy khi nhập URL vào Thanh địa chỉ trên trình duyệt.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Ứng dụng được khởi chạy từ lệnh gọi nội bộ của Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Ứng dụng được chạy từ phím tắt để mở ứng dụng.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Ứng dụng được khởi chạy bằng cách nhấp vào một đường liên kết trong một ứng dụng hoặc WebUI khác.
APPLICATION_LAUNCH_SOURCE_MENU Ứng dụng được chạy từ trình đơn.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Ứng dụng được chạy từ thông báo đã cài đặt.
APPLICATION_LAUNCH_SOURCE_TEST Ứng dụng được chạy từ một bài kiểm thử.
APPLICATION_LAUNCH_SOURCE_ARC Ứng dụng được chạy từ Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Ứng dụng được chạy từ Trang chia sẻ.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Ứng dụng được chạy từ thông báo ghi chú phát hành.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Ứng dụng được khởi chạy từ một quá trình khôi phục hoàn toàn.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Ứng dụng được chạy từ trình đơn theo bối cảnh lựa chọn văn bản thông minh.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Ứng dụng được chạy từ thông báo trên thẻ Khám phá.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Ứng dụng được chạy từ API Quản lý.
APPLICATION_LAUNCH_SOURCE_KIOSK Ứng dụng được chạy từ kiosk.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Ứng dụng được chạy từ dòng lệnh.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Ứng dụng được chạy ở chế độ nền.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Ứng dụng được chạy từ trang thẻ mới.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Ứng dụng được khởi chạy từ URL ý định.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Ứng dụng được chạy từ quy trình đăng nhập vào hệ điều hành.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Ứng dụng được chạy từ trình xử lý giao thức.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Ứng dụng được chạy từ trình xử lý URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Ứng dụng được chạy từ trình chạy ứng dụng trên màn hình khoá.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Ứng dụng được khởi chạy từ trang chủ ứng dụng (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Ứng dụng được chạy từ việc di chuyển nội dung vào một ứng dụng.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Ứng dụng được khởi chạy từ trình đơn hồ sơ của giao diện người dùng web chrome://password-manager có thể cài đặt.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Ứng dụng được chạy từ lịch trong khay hệ thống.
APPLICATION_LAUNCH_SOURCE_INSTALLER Ứng dụng được chạy từ trình cài đặt nguồn.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Hãy tính riêng số lần chạy ứng dụng Trợ giúp lần đầu để chúng ta có thể hiểu được số lần chạy do người dùng kích hoạt.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Ứng dụng được chạy từ phần hướng dẫn chào mừng.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Ứng dụng được chạy từ bảng điều khiển tiêu điểm.
APPLICATION_LAUNCH_SOURCE_SPARKY Ứng dụng được chạy từ tính năng thử nghiệm Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Ứng dụng được chạy từ tính năng ghi lại thao tác điều hướng.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Ứng dụng được khởi chạy từ API cài đặt web.

TelemetryOsCrashEvent

Dữ liệu sự cố hệ điều hành.

Biểu diễn dưới dạng JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Trường
crashType

enum (CrashType)

Loại sự cố.
sessionType

enum (SessionType)

Loại phiên.
crashId

string

Mã sự cố.

CrashType

Mô tả loại sự cố.

Enum
CRASH_TYPE_UNSPECIFIED Không xác định được loại sự cố.
CRASH_TYPE_KERNEL Sự cố hạt nhân.
CRASH_TYPE_EMBEDDED_CONTROLLER Sự cố với tay điều khiển được nhúng.

SessionType

Mô tả loại phiên.

Enum
SESSION_TYPE_UNSPECIFIED Không xác định được loại phiên.
SESSION_TYPE_SIGNED_IN_USER Người dùng đã đăng nhập.
SESSION_TYPE_KIOSK Kiosk.
SESSION_TYPE_MANAGED_GUEST Phiên khách được quản lý.
SESSION_TYPE_ACTIVE_DIRECTORY Phiên Active Directory.

Phương thức

list

 Liệt kê các sự kiện đo từ xa.