REST Resource: customers.telemetry.events

Recurso: TelemetryEvent

Datos de telemetría informados por un dispositivo administrado.

Representación 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)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso del evento.

device

object (TelemetryDeviceInfo)

Solo salida. Información sobre el dispositivo asociado con el evento.

user

object (TelemetryUserInfo)

Solo salida. Información sobre el usuario asociado con el evento.

reportTime

string (Timestamp format)

Marca de tiempo que representa cuándo se informó el evento.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

eventType

enum (EventType)

Es el tipo de evento actual.

audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Solo salida. Carga útil para el evento de subcarga grave de audio. Solo está presente cuando el campo eventType es AUDIO_SEVERE_UNDERRUN.

usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo salida. Carga útil para el evento de periféricos USB. Solo está presente cuando el campo eventType es USB_ADDED o USB_REMOVED.

networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo salida. Carga útil para el evento de cambio de estado de la conexión de red. Solo está presente cuando eventType es NETWORK_STATE_CHANGE.

httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo salida. Carga útil para el evento de cambio de latencia de HTTPS. Solo está presente cuando eventType es NETWORK_HTTPS_LATENCY_CHANGE.

wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo salida. Carga útil para eventos de intensidad de la señal de Wi-Fi Solo está presente cuando eventType es WIFI_SIGNAL_STRENGTH_LOW o WIFI_SIGNAL_STRENGTH_RECOVERED.

vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo salida. Carga útil para el evento de cambio de estado de la conexión de VPN. Solo está presente cuando eventType es VPN_CONNECTION_STATE_CHANGE.

appInstallEvent

object (TelemetryAppInstallEvent)

Solo salida. Carga útil del evento de instalación de aplicación. Solo está presente cuando eventType es APP_INSTALLED.

appUninstallEvent

object (TelemetryAppUninstallEvent)

Solo salida. Carga útil para el evento de desinstalación de la app. Solo está presente cuando eventType es APP_UNINSTALLED.

appLaunchEvent

object (TelemetryAppLaunchEvent)

Solo salida. Carga útil para el evento de inicio de la app.Solo se presenta cuando eventType es APP_LAUNCHED.

osCrashEvent

object (TelemetryOsCrashEvent)

Solo salida. Carga útil para el evento de falla del SO. Solo está presente cuando eventType es OS_CRASH.

TelemetryDeviceInfo

Información sobre un dispositivo asociado con datos de telemetría.

  • Se necesita permiso detallado: TELEMETRY_API_DEVICE
Representación JSON
{
  "deviceId": string,
  "orgUnitId": string
}
Campos
deviceId

string

Solo salida. Es el ID único de la API de Directory del dispositivo. Este valor es el mismo que el ID de la API de Directory de la Consola del administrador en la pestaña Dispositivos ChromeOS.

orgUnitId

string

Solo salida. Es el ID de la unidad organizativa del dispositivo.

TelemetryUserInfo

Información sobre un usuario asociada con datos de telemetría.

  • Se necesita permiso detallado: TELEMETRY_API_USER
Representación JSON
{
  "email": string,
  "orgUnitId": string
}
Campos
email

string

Solo salida. Es el correo electrónico del usuario.

orgUnitId

string

Solo salida. Es el ID de la unidad organizativa del usuario.

TelemetryAudioSevereUnderrunEvent

Este tipo no tiene campos.

TelemetryAudioSevereUnderrunEvent se activa cuando un dispositivo de audio se queda sin datos de búfer durante más de 5 segundos.

  • Se requiere permiso detallado: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent se activa cuando se agregan o quitan dispositivos USB.

  • Se necesita permiso detallado: TELEMETRY_API_PERIPHERALS_REPORT
Representación JSON
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Campos
usbPeripheralReport[]

object (UsbPeripheralReport)

Es la lista de dispositivos USB que se agregaron o quitaron.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent se activa cuando cambia el estado de la conexión de red.

  • Se necesita permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Campos
guid

string

Es el identificador único de la red.

connectionState

enum (NetworkConnectionState)

Estado de conexión actual de la red.

TelemetryHttpsLatencyChangeEvent

La rutina de latencia de HTTPS se ejecuta periódicamente y se activa TelemetryHttpsLatencyChangeEvent si se detectó un problema de latencia o si el dispositivo se recuperó de un problema de latencia.

  • Se necesita permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campos
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Datos de rutina de latencia de HTTPS que activaron el evento.

httpsLatencyState

enum (HttpsLatencyState)

Estado actual de la latencia de HTTPS.

HttpsLatencyState

Estado de latencia de HTTPS.

Enumeraciones
HTTPS_LATENCY_STATE_UNSPECIFIED El estado de latencia de HTTPS no está especificado.
RECOVERY La latencia de HTTPS se recuperó de un problema.
PROBLEM Problema de latencia de HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent se activa en eventos de intensidad de la señal de Wi-Fi.

  • Se necesita permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON
{
  "guid": string,
  "signalStrengthDbm": integer
}
Campos
guid

string

Es el identificador único de la red.

signalStrengthDbm

integer

Es el valor de RSSI de la intensidad de la señal.

TelemetryAppInstallEvent

Datos de instalación de la app.

Representación JSON
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campos
appInstallSource

enum (ApplicationInstallSource)

Es la fuente de instalación de la app.

appInstallReason

enum (ApplicationInstallReason)

Motivo de la instalación de la app.

appInstallTime

enum (ApplicationInstallTime)

El tiempo de instalación de la app depende del ciclo de vida de la app.

appId

string

ID de la app. Para las AWP, esta es la URL de inicio y, para las extensiones, es el ID de la extensión.

appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationInstallSource

Describe la fuente de instalación de la app.

Enumeraciones
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Se desconoce la fuente de instalación de la aplicación.
APPLICATION_INSTALL_SOURCE_SYSTEM Aplicación instalada como parte del Sistema operativo Chrome.
APPLICATION_INSTALL_SOURCE_SYNC La fuente de instalación de la aplicación es una sincronización.
APPLICATION_INSTALL_SOURCE_PLAY_STORE La fuente de instalación de la aplicación es Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE La fuente de instalación de la aplicación es Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER La fuente de instalación de la aplicación es un navegador.

ApplicationInstallReason

Describe el motivo de la instalación de la app.

Enumeraciones
APPLICATION_INSTALL_REASON_UNSPECIFIED Se desconoce el motivo de la instalación de la aplicación.
APPLICATION_INSTALL_REASON_SYSTEM Es una aplicación instalada con el sistema y se considera parte del SO.
APPLICATION_INSTALL_REASON_POLICY Aplicación instalada por política
APPLICATION_INSTALL_REASON_OEM Aplicación instalada por un fabricante de equipos originales (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Aplicación instalada de forma predeterminada, pero que no se considera una app del sistema.
APPLICATION_INSTALL_REASON_SYNC Aplicación instalada por sincronización.
APPLICATION_INSTALL_REASON_USER Aplicación instalada por acción del usuario.
APPLICATION_INSTALL_REASON_SUB_APP Llamada a la API de SubApp de la aplicación instalada
APPLICATION_INSTALL_REASON_KIOSK Aplicación instalada por el kiosco en ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplicación instalada por argumento de línea de comandos

ApplicationInstallTime

Describe el tiempo de instalación de la app según su ciclo de vida.

Enumeraciones
APPLICATION_INSTALL_TIME_UNSPECIFIED Se desconoce el tiempo de instalación de la aplicación.
APPLICATION_INSTALL_TIME_INIT Se inicializa la instalación de la aplicación.
APPLICATION_INSTALL_TIME_RUNNING La instalación de la aplicación se está ejecutando.

TelemetryAppUninstallEvent

Datos de desinstalación de apps

Representación JSON
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campos
appUninstallSource

enum (ApplicationUninstallSource)

Fuente de desinstalación de la app.

appId

string

ID de la app. Para las AWP, esta es la URL de inicio y, para las extensiones, es el ID de la extensión.

appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationUninstallSource

Describe la fuente de desinstalación de la app.

Enumeraciones
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED La fuente de desinstalación de la aplicación es desconocida.
APPLICATION_UNINSTALL_SOURCE_APP_LIST La aplicación se desinstaló de la lista de aplicaciones (selector).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT La aplicación se desinstaló de la página Administración de aplicaciones.
APPLICATION_UNINSTALL_SOURCE_SHELF Se desinstaló la aplicación de la biblioteca.
APPLICATION_UNINSTALL_SOURCE_MIGRATION La aplicación se desinstaló por la migración de apps.

TelemetryAppLaunchEvent

Datos de inicio de la app

Representación JSON
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campos
appLaunchSource

enum (ApplicationLaunchSource)

Fuente de inicio de la app.

appId

string

ID de la app. Para las AWP, esta es la URL de inicio y, para las extensiones, es el ID de la extensión.

appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationLaunchSource

Describe la fuente de inicio de la app.

Enumeraciones
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Se desconoce la fuente de inicio de la aplicación.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID La aplicación se inicia desde la cuadrícula de apps, no desde el cuadro de búsqueda.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplicación iniciada desde la cuadrícula de apps, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY La aplicación se inicia desde resultados dependientes de la consulta (íconos más grandes).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU La aplicación se inicia desde resultados dependientes de la consulta, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplicación iniciada desde recomendaciones sin búsqueda (íconos más pequeños).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Se inició la aplicación desde la sección Configuración de controles parentales y la notificación de tiempo por app.
APPLICATION_LAUNCH_SOURCE_SHELF Se inició la aplicación desde la biblioteca.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplicación iniciada desde el administrador de archivos
APPLICATION_LAUNCH_SOURCE_OMNIBOX La aplicación se inicia cuando se ingresa una URL en el cuadro multifunción del navegador.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplicación iniciada desde una llamada interna de Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD La aplicación se inicia desde la combinación de teclas para abrir la app.
APPLICATION_LAUNCH_SOURCE_OTHER_APP La aplicación se inicia haciendo clic en un vínculo en otra app o IU web.
APPLICATION_LAUNCH_SOURCE_MENU Se inició la aplicación desde el menú.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplicación iniciada desde la notificación instalada.
APPLICATION_LAUNCH_SOURCE_TEST La aplicación se inició desde una prueba.
APPLICATION_LAUNCH_SOURCE_ARC Aplicación iniciada desde Arc
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplicación iniciada desde la hoja compartida.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION La aplicación se inició desde la notificación de las notas de la versión.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE La aplicación se inició desde un restablecimiento completo.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplicación iniciada desde un menú contextual de selección de texto inteligente.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Aplicación iniciada desde una notificación de la pestaña Descubre.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplicación iniciada desde la API de Management
APPLICATION_LAUNCH_SOURCE_KIOSK Se inició la aplicación desde el kiosco.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE La aplicación se inició desde la línea de comandos.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE La aplicación se inició desde el modo en segundo plano.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Aplicación iniciada desde la página Nueva pestaña.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Aplicación iniciada desde una URL de intent
APPLICATION_LAUNCH_SOURCE_OS_LOGIN La aplicación se inició desde el acceso al SO.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER La aplicación se inició desde el controlador de protocolos.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER La aplicación se inició desde el controlador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN La aplicación se inició desde el selector de apps de la pantalla de bloqueo.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE La aplicación se inicia desde la página principal de la app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplicación iniciada cuando se mueve contenido a una app
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Se inició la aplicación desde el menú de perfil de la IU web instalable chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR La aplicación se inicia desde el calendario de la bandeja del sistema.
APPLICATION_LAUNCH_SOURCE_INSTALLER La aplicación se inició desde el instalador de la fuente.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Cuenta los inicios de la app de ayuda de primera ejecución por separado para que podamos comprender la cantidad de inicios activados por el usuario.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR La aplicación se inició desde la visita de bienvenida.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Se inició la aplicación desde el panel de enfoque.
APPLICATION_LAUNCH_SOURCE_SPARKY La aplicación se inició desde la función experimental Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Se inició la aplicación desde la captura de navegación.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Aplicación iniciada desde la API de instalación web.

TelemetryOsCrashEvent

Datos de fallas del SO

Representación JSON
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Campos
crashType

enum (CrashType)

Tipo de falla.

sessionType

enum (SessionType)

Tipo de sesión.

crashId

string

ID de falla

CrashType

Describe el tipo de falla.

Enumeraciones
CRASH_TYPE_UNSPECIFIED Tipo de falla desconocido.
CRASH_TYPE_KERNEL Falla del kernel.
CRASH_TYPE_EMBEDDED_CONTROLLER Falla del controlador incorporado.

SessionType

Describe el tipo de sesión.

Enumeraciones
SESSION_TYPE_UNSPECIFIED Tipo de sesión desconocido.
SESSION_TYPE_SIGNED_IN_USER Usuario que accedió a su cuenta
SESSION_TYPE_KIOSK Kiosco.
SESSION_TYPE_MANAGED_GUEST Sesión de invitado administrada.
SESSION_TYPE_ACTIVE_DIRECTORY Sesión de Active Directory

Métodos

list

Enumera los eventos de telemetría.