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)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  }
}
Поля
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 .

appInstallEvent

object ( TelemetryAppInstallEvent )

Только вывод. Полезная нагрузка для события установки приложения. Присутствует только в том случае, если eventType равен APP_INSTALLED .

appUninstallEvent

object ( TelemetryAppUninstallEvent )

Только вывод. Полезная нагрузка для события удаления приложения. Присутствует только в том случае, если eventType равен APP_UNINSTALLED .

appLaunchEvent

object ( TelemetryAppLaunchEvent )

Только вывод. Полезная нагрузка для события запуска приложения. Присутствует только в том случае, если eventType имеет значение APP_LAUNCHED .

Телеметрия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.

ТелеметрияAppInstallEvent

Данные об установке приложения.

JSON-представление
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Поля
appInstallSource

enum ( ApplicationInstallSource )

Источник установки приложения.

appInstallReason

enum ( ApplicationInstallReason )

Причина установки приложения.

appInstallTime

enum ( ApplicationInstallTime )

Время установки приложения зависит от жизненного цикла приложения.

appId

string

Идентификатор приложения. Для PWA это начальный URL-адрес, а для расширений — идентификатор расширения.

appType

enum ( TelemetryApplicationType )

Тип приложения.

Источник установки приложения

Описывает источник установки приложения.

Перечисления
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Источник установки приложения неизвестен.
APPLICATION_INSTALL_SOURCE_SYSTEM Приложение установлено как часть Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC Источником установки приложения является синхронизация.
APPLICATION_INSTALL_SOURCE_PLAY_STORE Источником установки приложения является магазин Play.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE Источником установки приложения является интернет-магазин Chrome.
APPLICATION_INSTALL_SOURCE_BROWSER Источником установки приложения является браузер.

Причина установки приложения

Описывает причину установки приложения.

Перечисления
APPLICATION_INSTALL_REASON_UNSPECIFIED Причина установки приложения неизвестна.
APPLICATION_INSTALL_REASON_SYSTEM Приложение устанавливается вместе с системой и считается частью ОС.
APPLICATION_INSTALL_REASON_POLICY Приложение установлено политикой.
APPLICATION_INSTALL_REASON_OEM Приложение установлено производителем оригинального оборудования (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Приложение установлено по умолчанию, но не считается системным.
APPLICATION_INSTALL_REASON_SYNC Приложение установлено синхронизацией.
APPLICATION_INSTALL_REASON_USER Приложение установлено по действию пользователя.
APPLICATION_INSTALL_REASON_SUB_APP Приложение установлено bt Вызов API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Приложение, установленное Kiosk на Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Приложение установлено с помощью аргумента командной строки.

Время установки приложения

Описывает время установки приложения в зависимости от жизненного цикла приложения.

Перечисления
APPLICATION_INSTALL_TIME_UNSPECIFIED Время установки приложения неизвестно.
APPLICATION_INSTALL_TIME_INIT Установка приложения инициализируется.
APPLICATION_INSTALL_TIME_RUNNING Установка приложения в настоящее время выполняется.

ТелеметрияAppUninstallEvent

Данные об удалении приложения.

JSON-представление
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Поля
appUninstallSource

enum ( ApplicationUninstallSource )

Источник удаления приложения.

appId

string

Идентификатор приложения. Для PWA это начальный URL-адрес, а для расширений — идентификатор расширения.

appType

enum ( TelemetryApplicationType )

Тип приложения.

ПриложениеУдалитьИсточник

Описывает источник удаления приложения.

Перечисления
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Источник удаления приложения неизвестен.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Приложение удалено из списка приложений (панели запуска).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Приложение удалено со страницы «Управление приложениями».
APPLICATION_UNINSTALL_SOURCE_SHELF Приложение удалено с Полки.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Приложение удалено в результате миграции приложения.

ТелеметрияAppLaunchEvent

Данные о запуске приложения.

JSON-представление
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Поля
appLaunchSource

enum ( ApplicationLaunchSource )

Источник запуска приложения.

appId

string

Идентификатор приложения. Для PWA это начальный URL-адрес, а для расширений — идентификатор расширения.

appType

enum ( TelemetryApplicationType )

Тип приложения.

Источник запуска приложения

Описывает источник запуска приложения.

Перечисления
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Источник запуска приложения неизвестен.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Приложение запускается из сетки приложений, а не из окна поиска.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Приложение запускается из сетки приложений, вне контекстного меню.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Приложение запускается на основе результатов, зависящих от запроса (более крупные значки).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Приложение запускается из результатов, зависящих от запроса, вне контекстного меню.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Приложение запускается из рекомендаций без запросов (значки меньшего размера).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Приложение запускается из раздела «Настройки родительского контроля» и уведомления о времени для каждого приложения.
APPLICATION_LAUNCH_SOURCE_SHELF Приложение запущено с полки.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Приложение запускается из файлового менеджера
APPLICATION_LAUNCH_SOURCE_OMNIBOX Приложение запускается после ввода URL-адреса в омнибоксе браузера.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Приложение запускается из внутреннего вызова Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Приложение запускается с помощью сочетания клавиш для открытия приложения.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Приложение запускается при нажатии ссылки в другом приложении или веб-интерфейсе.
APPLICATION_LAUNCH_SOURCE_MENU Приложение запускается из меню.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Приложение запускается из установленного уведомления.
APPLICATION_LAUNCH_SOURCE_TEST Приложение запущено из теста.
APPLICATION_LAUNCH_SOURCE_ARC Приложение запускается из Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Приложение запускается из Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Приложение запускается из уведомления о примечаниях к выпуску.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Приложение запускается из полного восстановления.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Приложение запускается из контекстного меню интеллектуального выбора текста.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Приложение запускается из уведомления на вкладке обнаружения.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Приложение, запущенное из Management API.
APPLICATION_LAUNCH_SOURCE_KIOSK Приложение запущено из киоска.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Приложение запускается из командной строки.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Приложение запускается из фонового режима.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Приложение запускается с новой вкладки.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Приложение запущено с URL-адреса намерения.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Приложение запускается при входе в ОС.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Приложение запускается из обработчика протокола.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Приложение запущено из обработчика URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Приложение запускается из панели запуска приложений на экране блокировки.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Приложение запускается с домашней страницы приложения ( chrome://apps ).
APPLICATION_LAUNCH_SOURCE_REPARENTING Приложение запущено после перемещения контента в приложение.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Приложение запускается из меню профиля устанавливаемого веб-интерфейса chrome://password-manager .
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Приложение запускается из календаря на панели задач.
APPLICATION_LAUNCH_SOURCE_INSTALLER Приложение запускается из установщика исходного кода.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Подсчитайте запуски приложения справки при первом запуске отдельно, чтобы мы могли понять количество запусков, инициированных пользователем.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Приложение запущено из приветственного тура.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Приложение запускается из фокус-панели.
APPLICATION_LAUNCH_SOURCE_SPARKY Приложение запущено с помощью экспериментальной функции Sparky.

Методы

list

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