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)
  }
}
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 el momento en que se informó el evento

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

Es el tipo de evento del evento actual.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Solo salida. Carga útil para un evento de subdesbordamiento grave de audio. Presente solo cuando el campo eventType es AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo salida. Carga útil para eventos 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. Presente solo cuando eventType sea NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo salida. Carga útil para el evento de cambio de latencia de HTTPS Presente solo cuando eventType sea NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo salida. Carga útil para eventos de intensidad de la señal de Wi-Fi Presente solo cuando eventType sea WIFI_SIGNAL_STRENGTH_LOW o WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo salida. Carga útil para el evento de cambio de estado de conexión de VPN. Presente solo cuando eventType sea VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Solo salida. Carga útil para el evento de instalación de la app Presente solo cuando eventType sea APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Solo salida. Carga útil del evento de desinstalación de la app Presente solo cuando eventType sea APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Solo salida. Carga útil para el evento de inicio de la app.Solo está presente cuando eventType es APP_LAUNCHED.

TelemetryDeviceInfo

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

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

string

Solo salida. 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 de ChromeOS.
orgUnitId

string

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

TelemetryUserInfo

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

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

string

Solo salida. Correo electrónico del usuario.
orgUnitId

string

Solo salida. Es el ID de 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 necesita un permiso detallado: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Se activó TelemetryUsbPeripheralsEvent, y se agregaron o quitaron dispositivos USB.

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

object (UsbPeripheralReport)

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 un 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)

Es el estado actual de la conexión de la red.

TelemetryHttpsLatencyChangeEvent

La rutina de latencia 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 un permiso detallado: TELEMETRY_API_NETWORK_REPORT
Representación JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campos
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

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

enum (HttpsLatencyState)

Estado actual de la latencia de HTTPS

HttpsLatencyState

Estado de latencia de HTTPS.

Enumeradores
HTTPS_LATENCY_STATE_UNSPECIFIED No se especificó el estado de latencia de HTTPS.
RECOVERY Se recuperó la latencia de HTTPS de un problema.
PROBLEM Hay un problema de latencia de HTTPS.

TelemetryNetworkSignalStrengthEvent

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

  • Se necesita un 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

Intensidad de la señal de RSSI

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)

Fuente de instalación de la app
appInstallReason

enum (ApplicationInstallReason)

Es el motivo de la instalación de la app.
appInstallTime

enum (ApplicationInstallTime)

Tiempo de instalación de la app según su ciclo de vida
appId

string

ID de la app. Para las AWP, 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.

Enumeradores
APPLICATION_INSTALL_SOURCE_UNSPECIFIED La fuente de instalación de la aplicación es desconocida.
APPLICATION_INSTALL_SOURCE_SYSTEM Aplicación instalada como parte de ChromeOS.
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 instalación de la app.

Enumeradores
APPLICATION_INSTALL_REASON_UNSPECIFIED Se desconoce el motivo de la instalación de la aplicación.
APPLICATION_INSTALL_REASON_SYSTEM La aplicación se instala con el sistema y se considera parte de este.
APPLICATION_INSTALL_REASON_POLICY Aplicación instalada por política.
APPLICATION_INSTALL_REASON_OEM Aplicación instalada por un fabricante del equipo original (OEM).
APPLICATION_INSTALL_REASON_DEFAULT La aplicación se instala de forma predeterminada, pero 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 Aplicación instalada a través de una llamada a la API de SubApp.
APPLICATION_INSTALL_REASON_KIOSK Aplicación instalada por kiosco en ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplicación instalada por un argumento de línea de comandos.

ApplicationInstallTime

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

Enumeradores
APPLICATION_INSTALL_TIME_UNSPECIFIED Tiempo de instalación de la aplicación desconocido
APPLICATION_INSTALL_TIME_INIT Se inicializa la instalación de la aplicación.
APPLICATION_INSTALL_TIME_RUNNING Se está ejecutando la instalación de la aplicación.

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, 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.

Enumeradores
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Fuente de desinstalación de la aplicación desconocida.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Se desinstaló la aplicación de la Lista de aplicaciones (Selector).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Se desinstaló la aplicación desde la página Administración de apps.
APPLICATION_UNINSTALL_SOURCE_SHELF Se desinstaló la aplicación de la Barra.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Se desinstaló la aplicación debido a la migración.

TelemetryAppLaunchEvent

Datos de inicio de la app.

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

enum (ApplicationLaunchSource)

Es la fuente de inicio de la app.
appId

string

ID de la app. Para las AWP, 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.

Enumeradores
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Fuente de inicio de la aplicación desconocida.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Aplicación iniciada desde la cuadrícula de aplicaciones, 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 Aplicación iniciada desde resultados dependientes de la consulta (íconos más grandes)
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Aplicación iniciada desde resultados dependientes de la consulta, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplicación iniciada desde recomendaciones sin consultas (íconos más pequeños)
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS La aplicación se inició desde la sección Parental Controls Settings y la notificación de tiempo por app.
APPLICATION_LAUNCH_SOURCE_SHELF Se inició la aplicación desde la barra.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplicación iniciada desde el administrador de archivos
APPLICATION_LAUNCH_SOURCE_OMNIBOX La aplicación se inició al ingresar 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 Aplicación iniciada desde una combinación de teclas para abrir la aplicación.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplicación iniciada al hacer clic en un vínculo de otra app o WebUI
APPLICATION_LAUNCH_SOURCE_MENU Aplicación iniciada desde el menú
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplicación iniciada desde la notificación instalada.
APPLICATION_LAUNCH_SOURCE_TEST Aplicación iniciada a partir de una prueba
APPLICATION_LAUNCH_SOURCE_ARC Aplicación iniciada desde Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplicación iniciada desde Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplicación iniciada desde la notificación de notas de la versión
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplicación iniciada 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 pestaña de descubrimiento.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplicación iniciada desde la API de Management.
APPLICATION_LAUNCH_SOURCE_KIOSK Aplicación iniciada desde el kiosco
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplicación iniciada desde la línea de comandos
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Aplicación iniciada 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 Aplicación iniciada desde el Acceso al SO.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplicación iniciada desde el controlador de protocolos.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplicación iniciada desde el controlador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplicación iniciada desde el selector de aplicaciones de la pantalla de bloqueo
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplicación iniciada desde la página principal de la aplicación (chrome://apps)
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplicación iniciada después del traslado de contenido a una app
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Aplicación iniciada desde el menú de perfil de la IU web instalable chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplicación iniciada desde el calendario de la bandeja del sistema.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplicación iniciada desde el instalador de origen.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Considera los lanzamientos de aplicaciones de ayuda de primera ejecución por separado, de modo que podamos conocer la cantidad de lanzamientos activados por los usuarios.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Aplicación iniciada a partir del recorrido de bienvenida.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Se inició la aplicación desde el panel de enfoque.

Métodos

list

 Enumera los eventos de telemetría.