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 quan đến sự kiện này.
user

object (TelemetryUserInfo)

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

string (Timestamp format)

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 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 chạy ngầm âm thanh 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 về thiết bị ngoại vi USB. Chỉ trình bày 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 ở trạng thái 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 ở trạng thái NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Chỉ có đầu ra. Tải trọng cho các sự kiện về cường độ tín hiệu Wi-Fi. Chỉ trình bày khi eventType 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 ở trạng thái 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 ở trạng thái 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 ở trạng thái APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

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

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ã đơn vị tổ chức của thiết bị.

TelemetryUserInfo

Thông tin về người dùng liên quan đến 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. Địa chỉ 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.

TelemetryAudioSevereUnderrunEvent được kích hoạt khi thiết bị âm thanh hết dữ liệu bộ đệ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 là các thiết bị USB được thêm hoặc bị 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 những thiết bị USB đã được thêm 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 độ trễ HTTP được chạy định kỳ và TelemetryHttpsLatencyChangeEvent sẽ đượ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 từ sự cố 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ễ HTTPS hiện tại.

HttpsLatencyState

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

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

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent được kích hoạt khi có các sự kiện về 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 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à đây là mã tiện ích đối với các 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 dưới dạng một phần của Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC Nguồn cài đặt ứng dụng là một hoạt động đồ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 hệ thống và được xem 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 xem là ứng dụng hệ thống.
APPLICATION_INSTALL_REASON_SYNC Ứng dụng được cài đặt bằng cách đồ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 Ứng dụng đã cài đặt lệnh gọi API SubApp bt.
APPLICATION_INSTALL_REASON_KIOSK Ứng dụng do Kiosk trên Chrome OS cài đặt.
APPLICATION_INSTALL_REASON_COMMAND_LINE Ứng dụng được cài đặt theo đố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 Quá trình cài đặt ứng dụng hiện đang chạy.

TelemetryAppUninstallEvent

Dữ liệu 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à đây là mã tiện ích đối với các 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 Đã gỡ cài đặt ứng dụng 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 Ứng dụng được quản lý.
APPLICATION_UNINSTALL_SOURCE_SHELF Đã gỡ cài đặt ứng dụng khỏi Kệ.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Ứng dụng bị gỡ cài đặt bằng cách 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 và đây là mã tiện ích đối với các 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, không phải từ 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, nằm ngoài trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Ứng dụng khởi 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 khởi chạy qua các kết quả phụ thuộc vào truy vấn, nằm ngoài trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Ứng dụng khởi 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 khởi chạy trong phần Cài đặt chế độ 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 khởi chạy từ kệ.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Ứng dụng đã chạy từ trình quản lý tệp
APPLICATION_LAUNCH_SOURCE_OMNIBOX Ứng dụng chạy bằng cách nhập một URL vào Thanh địa chỉ trên trình duyệt.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Ứng dụng đã chạy từ một cuộc gọi nội bộ của Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Ứng dụng đã khởi 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 đường liên kết trong một ứng dụng khác hoặc WebUI.
APPLICATION_LAUNCH_SOURCE_MENU Ứng dụng đã khởi chạy từ trình đơn.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Ứng dụng đã chạy từ thông báo đã cài đặt.
APPLICATION_LAUNCH_SOURCE_TEST Ứng dụng chạy qua một quá trình kiểm thử.
APPLICATION_LAUNCH_SOURCE_ARC Ứng dụng chạy qua Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Ứng dụng chạy qua Trang chia sẻ nội dung.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Ứng dụng chạy từ thông báo ghi chú phát hành.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Ứng dụng đã khởi chạy từ bản khôi phục hoàn toàn.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Ứng dụng khởi 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 chạy qua thông báo trên thẻ Khám phá.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Ứng dụng đã khởi 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 chạy từ dòng lệnh.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Ứng dụng được khởi 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 đã chạy từ một URL ý định.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Ứng dụng chạy từ quá trình đăng nhập vào hệ điều hành.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Ứng dụng đã chạy từ trình xử lý giao thức.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Ứng dụng đã 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ủ ứng dụng (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Ứng dụng khởi 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 đã 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 đã chạy từ lịch của khay hệ thống.
APPLICATION_LAUNCH_SOURCE_INSTALLER Ứng dụng được khởi chạy từ trình cài đặt nguồn.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Tính riêng các lần khởi chạy ứng dụng Trợ giúp trong lần chạy đầu tiên để chúng tôi có thể biết số lần khởi chạy do người dùng kích hoạt.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Ứng dụng đã được 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.

Phương thức

list

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