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

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

osCrashEvent

object ( TelemetryOsCrashEvent )

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

externalDisplaysEvent

object ( TelemetryExternalDisplayEvent )

Только вывод. Полезная нагрузка для события подключения/отключения внешнего дисплея. Присутствует только тогда, когда eventType имеет значение EXTERNAL_DISPLAY_CONNECTED или EXTERNAL_DISPLAY_DISCONNECTED .

TelemetryDeviceInfo

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

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

string

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

orgUnitId

string

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

TelemetryUserInfo

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

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

string

Только вывод. Адрес электронной почты пользователя.

orgUnitId

string

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

TelemetryAudioSevereUnderrunEvent

Этот тип не содержит полей.

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

  • Требуется более детальный уровень доступа: TELEMETRY_API_AUDIO_REPORT

ТелеметрияUSBПериферийные устройстваСобытие

Событие TelemetryUsbPeripheralsEvent срабатывает, когда USB-устройства добавляются или удаляются.

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

object ( UsbPeripheralReport )

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

Событие изменения состояния подключения к сети TelemetryNetworkConnectionState

Событие TelemetryNetworkConnectionStateChangeEvent срабатывает при изменении состояния сетевого соединения.

  • Требуются детальные права доступа: TELEMETRY_API_NETWORK_REPORT
JSON-представление 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Поля
guid

string

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

connectionState

enum ( NetworkConnectionState )

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

TelemetryHttpsLatencyChangeEvent

Процедура проверки задержки 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.

TelemetryAppInstallEvent

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

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 )

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

ApplicationInstalSource

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

Перечисления
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 Приложение, установленное киоском на Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Приложение устанавливается с помощью аргумента командной строки.

ApplicationInstalLight

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

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

TelemetryAppUninstallEvent

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

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 Приложение удалено из списка приложений (лаунчера).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Приложение удалено со страницы «Управление приложениями».
APPLICATION_UNINSTALL_SOURCE_SHELF Приложение удалено из папки "Удаление".
APPLICATION_UNINSTALL_SOURCE_MIGRATION Приложение удалено в процессе миграции приложений.

TelemetryAppLaunchEvent

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

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-адресу, полученному через Intent.
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 веб-установки.

TelemetryOsCrashEvent

Данные о сбоях операционной системы.

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

enum ( CrashType )

Тип аварии.

sessionType

enum ( SessionType )

Тип сессии.

crashId

string

Идентификатор аварии.

CrashType

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

Перечисления
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 Сессия Active Directory.

TelemetryExternalDisplayEvent

Содержимое файла события подключения/отключения внешнего дисплея.

JSON-представление 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Поля
externalDisplayData[]

object ( TelemetryExternalDisplayData )

Список подключенных/отключенных внешних дисплеев.

TelemetryExternalDisplayData

Данные внешнего дисплея.

JSON-представление 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Поля
displayName

string

Отображаемое имя.

resolutionHorizontal

integer

Горизонтальное разрешение.

resolutionVertical

integer

Вертикальное разрешение.

refreshRate

string ( int64 format)

Частота обновления.

serialNumber

integer

Серийный номер.

edidVersion

string

Версия EDID.

Методы

list

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

Источник: 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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
Поля
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 )

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

osCrashEvent

object ( TelemetryOsCrashEvent )

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

externalDisplaysEvent

object ( TelemetryExternalDisplayEvent )

Только вывод. Полезная нагрузка для события подключения/отключения внешнего дисплея. Присутствует только тогда, когда eventType имеет значение EXTERNAL_DISPLAY_CONNECTED или EXTERNAL_DISPLAY_DISCONNECTED .

TelemetryDeviceInfo

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

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

string

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

orgUnitId

string

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

TelemetryUserInfo

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

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

string

Только вывод. Адрес электронной почты пользователя.

orgUnitId

string

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

TelemetryAudioSevereUnderrunEvent

Этот тип не содержит полей.

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

  • Требуется более детальный уровень доступа: TELEMETRY_API_AUDIO_REPORT

ТелеметрияUSBПериферийные устройстваСобытие

Событие TelemetryUsbPeripheralsEvent срабатывает, когда USB-устройства добавляются или удаляются.

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

object ( UsbPeripheralReport )

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

Событие изменения состояния подключения к сети TelemetryNetworkConnectionState

Событие TelemetryNetworkConnectionStateChangeEvent срабатывает при изменении состояния сетевого соединения.

  • Требуются детальные права доступа: TELEMETRY_API_NETWORK_REPORT
JSON-представление 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Поля
guid

string

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

connectionState

enum ( NetworkConnectionState )

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

TelemetryHttpsLatencyChangeEvent

Процедура проверки задержки 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.

TelemetryAppInstallEvent

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

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 )

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

ApplicationInstalSource

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

Перечисления
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 Приложение, установленное киоском на Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Приложение устанавливается с помощью аргумента командной строки.

ApplicationInstalLight

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

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

TelemetryAppUninstallEvent

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

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 Приложение удалено из списка приложений (лаунчера).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Приложение удалено со страницы «Управление приложениями».
APPLICATION_UNINSTALL_SOURCE_SHELF Приложение удалено из папки "Удаление".
APPLICATION_UNINSTALL_SOURCE_MIGRATION Приложение удалено в процессе миграции приложений.

TelemetryAppLaunchEvent

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

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-адресу, полученному через Intent.
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 веб-установки.

TelemetryOsCrashEvent

Данные о сбоях операционной системы.

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

enum ( CrashType )

Тип аварии.

sessionType

enum ( SessionType )

Тип сессии.

crashId

string

Идентификатор аварии.

CrashType

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

Перечисления
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 Сессия Active Directory.

TelemetryExternalDisplayEvent

Содержимое файла события подключения/отключения внешнего дисплея.

JSON-представление 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Поля
externalDisplayData[]

object ( TelemetryExternalDisplayData )

Список подключенных/отключенных внешних дисплеев.

TelemetryExternalDisplayData

Данные внешнего дисплея.

JSON-представление 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Поля
displayName

string

Отображаемое имя.

resolutionHorizontal

integer

Горизонтальное разрешение.

resolutionVertical

integer

Вертикальное разрешение.

refreshRate

string ( int64 format)

Частота обновления.

serialNumber

integer

Серийный номер.

edidVersion

string

Версия EDID.

Методы

list

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