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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
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 liên quan đến 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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. Tải trọng cho sự kiện thiếu hụt â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 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. Tải trọng 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. Tải trọng 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. Tải trọng 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. Tải trọng 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. Tải trọng 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. Tải trọng 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. Tải trọng 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. Tải trọng cho sự kiện hệ điều hành gặp sự cố. Chỉ xuất hiện khi eventType là OS_CRASH.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Chỉ có đầu ra. Tải trọng cho sự kiện màn hình ngoài được kết nối/ngắt kết nối. Chỉ xuất hiện khi eventType là EXTERNAL_DISPLAY_CONNECTED hoặc EXTERNAL_DISPLAY_DISCONNECTED.

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 ở cấp độ 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 ở cấp độ 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ã nhận dạng đơn vị tổ chức của người dùng.

TelemetryAudioSevereUnderrunEvent

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

TelemetryAudioSevereUnderrunEvent sẽ được kích hoạt khi thiết bị âm thanh hết dữ liệu trong bộ nhớ đệ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 các thiết bị USB đã được thêm hoặc xoá.

TelemetryNetworkConnectionStateChangeEvent

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

  • 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 riêng biệ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

Thường xuyên chạy quy trình độ trễ Https 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ắc phục được 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 thường quy 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 đã khắc phục được vấn đề.
PROBLEM Vấn đề về độ trễ của HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent được kích hoạt khi xảy ra 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 riêng biệ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 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 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 do người dùng cài đặt.
APPLICATION_INSTALL_REASON_SUB_APP Ứng dụng được cài đặt bằng lệnh gọi SubApp API.
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 Đã khởi chạy quy trình cài đặt ứng dụng.
APPLICATION_INSTALL_TIME_RUNNING Quá trình cài đặt ứng dụng hiện đang diễn ra.

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 đã được 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 trên 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 đã được gỡ cài đặt bằng tính năng di chuyển ứng dụng.

TelemetryAppLaunchEvent

Dữ liệu về lượt 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, bên ngoài trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Ứng dụng được khởi 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 khởi chạy từ kết quả phụ thuộc vào cụm từ tìm kiếm, nằm ngoài trình đơn theo bối cảnh.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Ứng dụng được khởi chạy từ các đề xuất không có cụm từ tìm kiếm (biểu tượng nhỏ hơn).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Ứng dụng được khởi chạy từ phần Cài đặt quyền kiểm soát của cha mẹ và thông báo thời gian sử dụng cho từng ứ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 bạn nhập một 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ừ một lệnh gọi nội bộ của Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Ứng dụng được khởi chạy bằng phím tắt để mở ứng dụng.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Ứng dụng được khởi chạy khi người dùng 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 khởi 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 khởi chạy từ một bài kiểm thử.
APPLICATION_LAUNCH_SOURCE_ARC Ứng dụng được khởi chạy từ Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Ứng dụng được khởi 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 quy trình khôi phục hoàn toàn.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Ứng dụng được khởi chạy từ trình đơn theo bối cảnh chọn văn bản thông minh.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Ứng dụng được chạy từ một thông báo trên thẻ Khám phá.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Ứng dụng được khởi chạy từ API Quản lý.
APPLICATION_LAUNCH_SOURCE_KIOSK Ứng dụng được khởi chạy từ chế độ kiosk.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Ứng dụng được khởi chạy từ dòng lệnh.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Ứng dụng được khởi chạy ở chế độ nền.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Ứng dụng được khởi chạy từ trang thẻ mới.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Ứng dụng được khởi chạy từ một URL ý định.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Ứng dụng được khởi chạy từ tính năng đăng nhập vào hệ điều hành.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Ứng dụng được khởi chạy từ trình xử lý giao thức.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Ứng dụng được khởi 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ủ của ứng dụng (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Ứng dụng được khởi chạy từ nội dung đang di chuyển 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 WebUI chrome://password-manager có thể cài đặt.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Ứng dụng được khởi chạy từ lịch trong 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 Đếm riêng số lần khởi chạy ứng dụng Trợ giúp lần đầu để 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 khởi chạy từ 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 khởi chạy từ tính năng thử nghiệm Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Ứng dụng được khởi 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 về 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ã nhận dạng 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 Nhân hệ điều hành gặp sự cố.
CRASH_TYPE_EMBEDDED_CONTROLLER Bộ điều khiển nhúng gặp sự cố.

SessionType

Mô tả loại phiên.

Enum
SESSION_TYPE_UNSPECIFIED Loại phiên không xác định.
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.

TelemetryExternalDisplayEvent

Tải trọng của sự kiện màn hình ngoài được kết nối/ngắt kết nối.

Biểu diễn dưới dạng JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Trường
externalDisplayData[]

object (TelemetryExternalDisplayData)

Danh sách các màn hình ngoài đã kết nối/ngắt kết nối.

TelemetryExternalDisplayData

Dữ liệu màn hình bên ngoài.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Trường
displayName

string

Tên hiển thị.
resolutionHorizontal

integer

Độ phân giải ngang.
resolutionVertical

integer

Độ phân giải dọc.
refreshRate

string (int64 format)

Tốc độ làm mới.
serialNumber

integer

Số sê-ri.
edidVersion

string

Phiên bản EDID.

Phương thức

list

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