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)
  }
}
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.

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.

Phương thức

list

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