REST Resource: customers.telemetry.events

资源：TelemetryEvent

受管设备报告的遥测数据。

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)
  }
}
字段
name

string

仅供输出。事件的资源名称。
device

object (TelemetryDeviceInfo)

仅供输出。与事件关联的设备的相关信息。
user

object (TelemetryUserInfo)

仅供输出。与事件关联的用户的相关信息。
reportTime

string (Timestamp format)

表示事件报告时间的时间戳。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
eventType

enum (EventType)

当前事件的事件类型。
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

仅供输出。音频严重欠载事件的载荷。仅当 eventType 字段为 AUDIO_SEVERE_UNDERRUN 时存在。
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

仅供输出。USB 外围设备事件的载荷。仅当 eventType 字段为 USB_ADDED 或 USB_REMOVED 时存在。
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

仅供输出。网络连接状态更改事件的载荷。仅当 eventType 为 NETWORK_STATE_CHANGE 时存在。
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

仅供输出。HTTPS 延迟时间变化事件的载荷。仅当 eventType 为 NETWORK_HTTPS_LATENCY_CHANGE 时存在。
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

仅供输出。Wi-Fi 信号强度事件的载荷。仅当 eventType 为 WIFI_SIGNAL_STRENGTH_LOW 或 WIFI_SIGNAL_STRENGTH_RECOVERED 时存在。
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

仅供输出。VPN 连接状态更改事件的载荷。仅当 eventType 为 VPN_CONNECTION_STATE_CHANGE 时存在。

TelemetryDeviceInfo

与遥测数据关联的设备的相关信息。

  • 需要的细化权限：TELEMETRY_API_DEVICE
JSON 表示法 
{
  "deviceId": string,
  "orgUnitId": string
}
字段
deviceId

string

仅供输出。设备的唯一 Directory API ID。此值与管理控制台的“ChromeOS 设备”标签页中的 Directory API ID 相同。
orgUnitId

string

仅供输出。设备的组织部门 ID。

TelemetryUserInfo

与遥测数据关联的用户的相关信息。

  • 需要细化权限：TELEMETRY_API_USER
JSON 表示法 
{
  "email": string,
  "orgUnitId": string
}
字段
email

string

仅供输出。用户的电子邮件地址。
orgUnitId

string

仅供输出。用户的组织部门 ID。

TelemetryAudioSevereUnderrunEvent

此类型没有任何字段。

当音频设备的缓冲区数据耗尽时间超过 5 秒时，就会触发 TelemetryAudioSevereUnderrunEvent。

  • 需要细化权限：TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

被触发 TelemetryUsbPeripheralsEvent 时，系统会添加或移除 USB 设备。

  • 需要细化权限：TELEMETRY_API_PERIPHERALS_REPORT
JSON 表示法 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
字段
usbPeripheralReport[]

object (UsbPeripheralReport)

添加或移除的 USB 设备的列表。

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent 在网络连接状态发生变化时触发。

  • 需要细化权限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
字段
guid

string

网络的唯一标识符。
connectionState

enum (NetworkConnectionState)

网络的当前连接状态。

TelemetryHttpsLatencyChangeEvent

HTTP 延迟例程会定期运行，如果检测到延迟问题或设备已从延迟问题中恢复，就会触发 TelemetryHttpsLatencyChangeEvent。

  • 需要细化权限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
字段
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

触发事件的 HTTPS 延迟时间例程数据。
httpsLatencyState

enum (HttpsLatencyState)

当前的 HTTPS 延迟状态。

HttpsLatencyState

HTTPS 延迟状态。

枚举
HTTPS_LATENCY_STATE_UNSPECIFIED 未指定 HTTPS 延迟时间状态。
RECOVERY HTTPS 延迟从问题中恢复。
PROBLEM HTTPS 延迟问题。

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent 会在 Wi-Fi 信号强度事件时触发。

  • 需要细化权限：TELEMETRY_API_NETWORK_REPORT
JSON 表示法 
{
  "guid": string,
  "signalStrengthDbm": integer
}
字段
guid

string

网络的唯一标识符。
signalStrengthDbm

integer

信号强度 RSSI 值。

方法

list

 列出遥测事件。