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)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
Поля
name

string

Только вывод. Имя ресурса события.

device

object ( TelemetryDeviceInfo )

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

user

object ( TelemetryUserInfo )

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

reportTime

string ( Timestamp format)

Временная метка, указывающая, когда было сообщено о событии.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

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 )

Только вывод. Полезная нагрузка для событий уровня сигнала WiFi. Присутствует только когда 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 .

osCrashEvent

object ( TelemetryOsCrashEvent )

Только вывод. Полезная нагрузка для события сбоя ОС. Присутствует только когда eventType — OS_CRASH .

ТелеметрияDeviceInfo

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

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

string

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

orgUnitId

string

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

ТелеметрияUserInfo

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

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

string

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

orgUnitId

string

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

ТелеметрияАудиоСерьезноеНедогрузкаСобытие

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

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

  • Требуется детальное разрешение: TELEMETRY_API_AUDIO_REPORT

ТелеметрияUsbPeripheralsEvent

Событие TelemetryUsbPeripheralsEvent срабатывает при добавлении или удалении USB-устройств.

  • Требуется детальное разрешение: TELEMETRY_API_PERIPHERALS_REPORT
JSON-представление 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Поля
usbPeripheralReport[]

object ( UsbPeripheralReport )

Список USB-устройств, которые были добавлены или удалены.

ТелеметрияСетевоеСостояниеСоединенияИзменениеСобытия

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 срабатывает при изменении уровня сигнала WiFi.

  • Требуется детальное разрешение: 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 )

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

ApplicationInstallSource

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

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

ApplicationInstallReason

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

Перечисления
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 Приложение установлено посредством вызова 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 )

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

ApplicationUninstallSource

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

Перечисления
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Источник удаления приложения неизвестен.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Приложение удалено из списка приложений (Launcher).
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 )

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

ApplicationLaunchSource

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

Перечисления
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 Приложение запущено из 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.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Приложение запущено из навигационного захвата.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Приложение запущено с помощью API веб-установки.

ТелеметрияOsCrashEvent

Данные о сбоях ОС.

JSON-представление 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Поля
crashType

enum ( CrashType )

Тип аварии.

sessionType

enum ( SessionType )

Тип сеанса.

crashId

string

Идентификатор сбоя.

Тип аварии

Описывает тип аварии.

Перечисления
CRASH_TYPE_UNSPECIFIED Тип аварии неизвестен.
CRASH_TYPE_KERNEL Сбой ядра.
CRASH_TYPE_EMBEDDED_CONTROLLER Сбой встроенного контроллера.

Тип сеанса

Описывает тип сеанса.

Перечисления
SESSION_TYPE_UNSPECIFIED Тип сеанса неизвестен.
SESSION_TYPE_SIGNED_IN_USER Пользователь вошел в систему.
SESSION_TYPE_KIOSK Киоск.
SESSION_TYPE_MANAGED_GUEST Управляемая гостевая сессия.
SESSION_TYPE_ACTIVE_DIRECTORY Сеанс активного каталога.

Методы

list

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