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 .

ТелеметрияDeviceInfo

Информация об устройстве, связанная с данными телеметрии.

  • Необходимо детальное разрешение: TELEMETRY_API_DEVICE.
JSON-представление
{
  "deviceId": string,
  "orgUnitId": string
}
Поля
deviceId

string

Только вывод. Уникальный идентификатор API каталога устройства. Это значение совпадает с идентификатором Directory API консоли администратора на вкладке «Устройства ChromeOS».

orgUnitId

string

Только вывод. Идентификатор организационного подразделения устройства.

ТелеметрияUserInfo

Информация о пользователе, связанная с данными телеметрии.

  • Необходимо детальное разрешение: TELEMETRY_API_USER.
JSON-представление
{
  "email": string,
  "orgUnitId": string
}
Поля
email

string

Только вывод. Электронная почта пользователя.

orgUnitId

string

Только вывод. Идентификатор организационного подразделения пользователя.

ТелеметрияАудиоSevereUnderrunEvent

Этот тип не имеет полей.

TelemetryAudioSevereUnderrunEvent срабатывает, когда в аудиоустройстве заканчиваются данные буфера более 5 секунд.

  • Необходимо детальное разрешение: TELEMETRY_API_AUDIO_REPORT.

ТелеметрияUSBПериферияСобытие

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 )

Текущее состояние подключения к сети.

ТелеметрияHttpsLatencyChangeEvent

Процедура определения задержки Https запускается периодически, а 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 запускается при возникновении событий уровня сигнала Wi-Fi.

  • Необходимо детальное разрешение: TELEMETRY_API_NETWORK_REPORT.
JSON-представление
{
  "guid": string,
  "signalStrengthDbm": integer
}
Поля
guid

string

Уникальный идентификатор сети.

signalStrengthDbm

integer

Уровень сигнала Значение RSSI.

Методы

list

 Список событий телеметрии.