REST Resource: customers.telemetry.events

Tài nguyên: TelemetryEvent

Dữ liệu đo từ xa do một 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)
  }
}
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 thể hiện thời điểm sự kiện được báo cáo.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

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

object (TelemetryAudioSevereUnderrunEvent)

Chỉ có đầu ra. Tải trọng cho sự kiện âm thanh chạy ngầm nghiêm trọng. Chỉ trình bày khi trường eventType là AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

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

object (TelemetryHttpsLatencyChangeEvent)

Chỉ có đầu ra. Tải trọng cho sự kiện thay đổi độ trễ HTTPS. Chỉ trình bày khi eventType là NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

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

object (TelemetryAppInstallEvent)

Chỉ có đầu ra. Tải trọng cho sự kiện cài đặt ứng dụng. Chỉ trình bày khi eventType là APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Chỉ có đầu ra. Tải trọng cho sự kiện gỡ cài đặt ứng dụng. Chỉ trình bày khi eventType là APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Chỉ có đầu ra. Tải trọng cho sự kiện khởi chạy ứng dụng.Chỉ trình bày khi eventType là APP_LAUNCHED.

TelemetryDeviceInfo

Thông tin về một thiết bị 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ã đơn vị tổ chức của thiết bị.

TelemetryUserInfo

Thông tin về người dùng 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 một 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

Bạn có thể thêm hoặc xoá các thiết bị USB đã kích hoạt TelemetryUsbPeripheralsEvent.

  • 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 vào hoặc bị 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 về độ trễ Https được chạy định kỳ và TelemetryHttpsLatencyChangeEvent được kích hoạt nếu hệ thống phát hiện thấy vấn đề về độ trễ hoặc nếu thiết bị đã khôi phục sau khi gặp 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 quy trình về độ trễ HTTPS đã kích hoạt sự kiện.
httpsLatencyState

enum (HttpsLatencyState)

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

HttpsLatencyState

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

Enum
HTTPS_LATENCY_STATE_UNSPECIFIED Chưa xác định trạng thái độ trễ HTTPS.
RECOVERY Đã khôi phục độ trễ HTTPS sau một sự cố.
PROBLEM Vấn đề về độ trễ HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent được kích hoạt khi có 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ườ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, còn đối với tiện ích, đây là mã 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 Nguồn cài đặt ứng dụng không xác định.
APPLICATION_INSTALL_SOURCE_SYSTEM Ứng dụng được cài đặt như một phần của Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC Nguồn cài đặt ứng dụng là một nguồn đồ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à một 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 bằng hành động của người dùng.
APPLICATION_INSTALL_REASON_SUB_APP Ứng dụng đã cài đặt lệnh gọi API bt SubApp.
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 Thời gian cài đặt ứng dụng không xác định.
APPLICATION_INSTALL_TIME_INIT Đã khởi chạy quá trình cài đặt ứng dụng.
APPLICATION_INSTALL_TIME_RUNNING Hiện đang cài đặt ứng dụng.

TelemetryAppUninstallEvent

Dữ liệu về việc 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, còn đối với tiện ích, đây là mã 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 rõ 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 Đã gỡ cài đặt ứng dụng khỏi trang Quản lý ứng dụng.
APPLICATION_UNINSTALL_SOURCE_SHELF Đã gỡ cài đặt ứng dụng khỏi Kệ.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Đã gỡ cài đặt ứng dụng do quá trình di chuyển ứng dụng.

TelemetryAppLaunchEvent

Dữ liệu về việc 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 chạy ứng dụng.
appId

string

Mã ứng dụng. Đối với PWA, đây là URL bắt đầu, còn đối với tiện ích, đây là mã 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 Nguồn khởi chạy ứng dụng không xác định.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Ứng dụng được khởi 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 chạy từ lưới ứng dụng, không ở trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Ứng dụng được chạy từ các 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 chạy từ kết quả phụ thuộc vào cụm từ tìm kiếm, không ở trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Ứng dụng chạy từ các đề xuất không cần truy vấn (biểu tượng nhỏ hơn).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Ứng dụng này được chạy trong phần Cài đặt chế độ kiểm soát của cha mẹ và thông báo theo Thời gian cho mỗi ứng dụng.
APPLICATION_LAUNCH_SOURCE_SHELF Ứng dụng khởi 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 khởi 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 chạy từ một cuộc gọi nội bộ trên Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Ứng dụng đã chạy từ phím tắt để mở ứng dụng.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Ứng dụng khởi chạy bằng cách nhấp vào đường liên kết trong một ứng dụng hoặc giao diện người dùng web khác.
APPLICATION_LAUNCH_SOURCE_MENU Ứng dụng đã chạy từ trình đơn.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Ứng dụng được chạy qua thông báo đã cài đặt.
APPLICATION_LAUNCH_SOURCE_TEST Ứng dụng được chạy từ một thử nghiệm.
APPLICATION_LAUNCH_SOURCE_ARC Ứng dụng đã chạy qua Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Ứng dụng đã chạy từ Trang chia sẻ nội dung.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Ứng dụng được chạy thông qua thông báo ghi chú phát hành.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Ứng dụng đã chạy từ quá trình khôi phục hoàn toàn.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Ứng dụng đã 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 thẻ khám phá.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Ứng dụng đã chạy từ API Quản lý.
APPLICATION_LAUNCH_SOURCE_KIOSK Ứng dụng 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 đã chạy từ chế độ nền.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Ứng dụng đã chạy từ trang thẻ mới.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Ứng dụng được chạy từ một URL ý định.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Ứng dụng chạy khi đăng nhập vào hệ điều hành.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Ứng dụng đã khởi 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 đã 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 đã chạy từ trang chủ của ứng dụng (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Ứng dụng khởi chạy bằng cách chuyển nội dung vào ứng dụng.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Ứng dụng đã 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 đã chạy từ lịch của khay hệ thống.
APPLICATION_LAUNCH_SOURCE_INSTALLER Ứng dụng đã khởi chạy từ trình cài đặt nguồn.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Tính riêng lượt khởi chạy ứng dụng trợ giúp trong lần chạy đầu tiên để chúng ta có thể nắm được số lượt khởi chạy do người dùng kích hoạt.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Ứng dụng đã khởi chạy từ chuyến tham quan chào mừng.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Đã chạy ứng dụng từ bảng điều khiển tiêu điểm.
APPLICATION_LAUNCH_SOURCE_SPARKY Ứng dụng đã chạy từ tính năng thử nghiệm Sparky.

Phương thức

list

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