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

El tipo de evento del evento actual.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

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

object (TelemetryUsbPeripheralsEvent)

Solo salida. Carga útil para 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 del evento de cambio de estado de conexión de red. Solo presente cuando eventType tiene el valor NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo salida. Carga útil para el evento de cambio de latencia HTTPS. Solo presente cuando eventType tiene el valor NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo salida. Carga útil para eventos de intensidad de la señal 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 conexión de VPN. Solo presente cuando eventType tiene el valor VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Solo salida. Carga útil para el evento de instalación de la app. Solo presente cuando eventType tiene el valor APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Solo salida. Carga útil para el evento de desinstalación de la app. Solo presente cuando eventType tiene el valor APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

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

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. 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 de la pestaña Dispositivos 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 necesitan permisos detallados: 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 unidad organizativa del usuario.

TelemetryAudioSevereUnderrunEvent

Este tipo no tiene campos.

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

  • Se necesitan permisos detallados: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Se activó TelemetryUsbPeripheralsEvent cuando se agregaron o quitaron dispositivos USB.

  • Se necesitan permisos detallados: 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 necesitan permisos detallados: TELEMETRY_API_NETWORK_REPORT
Representación JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Campos
guid

string

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 detecta un problema de latencia o si el dispositivo se recuperó de un problema de latencia.

  • Se necesitan permisos detallados: TELEMETRY_API_NETWORK_REPORT
Representación JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campos
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Son los datos de rutina de latencia de HTTPS que activaron el evento.
httpsLatencyState

enum (HttpsLatencyState)

Estado actual de latencia de HTTPS.

HttpsLatencyState

Estado de latencia de HTTPS.

Enumeraciones
HTTPS_LATENCY_STATE_UNSPECIFIED No se especifica el estado de latencia de HTTPS.
RECOVERY La latencia de HTTPS se recupera de un problema.
PROBLEM Problema de latencia de HTTPS.

TelemetryNetworkSignalStrengthEvent

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

  • Se necesitan permisos detallados: TELEMETRY_API_NETWORK_REPORT
Representación JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Campos
guid

string

Identificador único de la red.
signalStrengthDbm

integer

Valor de RSSI de la intensidad de la señal.

TelemetryAppInstallEvent

Datos de instalación de apps.

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)

Motivo de instalación de la app.
appInstallTime

enum (ApplicationInstallTime)

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

string

Es el ID de la app. En el caso de las AWP, esta es la URL de inicio y, en el caso de 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 aplicaciones 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.

Enumeraciones
APPLICATION_INSTALL_REASON_UNSPECIFIED Se desconoce el motivo de la instalación de la aplicación.
APPLICATION_INSTALL_REASON_SYSTEM Aplicación instalada con el sistema y se considera parte del SO.
APPLICATION_INSTALL_REASON_POLICY Aplicación instalada por una política.
APPLICATION_INSTALL_REASON_OEM Aplicación instalada por el fabricante del equipo original (OEM)
APPLICATION_INSTALL_REASON_DEFAULT La aplicación se instala de forma predeterminada, pero no se considera una aplicación del sistema.
APPLICATION_INSTALL_REASON_SYNC La aplicación se instaló mediante la 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 instalada en la aplicación.
APPLICATION_INSTALL_REASON_KIOSK Aplicación instalada por kiosco en ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE La aplicación se instaló mediante el argumento de la 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 la fecha de instalación de la aplicación.
APPLICATION_INSTALL_TIME_INIT Se inicializó la instalación de la aplicación.
APPLICATION_INSTALL_TIME_RUNNING La instalación de la aplicación se está ejecutando en este momento.

TelemetryAppUninstallEvent

Datos de desinstalación de la app

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

enum (ApplicationUninstallSource)

Fuente de desinstalación de la app
appId

string

Es el ID de la app. En el caso de las AWP, esta es la URL de inicio y, en el caso de 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 Se desconoce la fuente de desinstalación de la aplicación.
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 de la página Administración de apps.
APPLICATION_UNINSTALL_SOURCE_SHELF Se desinstaló la aplicación de la barra.
APPLICATION_UNINSTALL_SOURCE_MIGRATION La migración de la app se desinstaló.

TelemetryAppLaunchEvent

Datos de inicio de la aplicación

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

enum (ApplicationLaunchSource)

Fuente de inicio de la app
appId

string

Es el ID de la app. En el caso de las AWP, esta es la URL de inicio y, en el caso de 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 aplicaciones, no desde el cuadro de búsqueda.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU La aplicación se inicia desde la cuadrícula de apps, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Aplicación iniciada desde los resultados que dependen de la consulta (íconos más grandes).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU La aplicación se inicia desde los resultados que dependen de la consulta, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplicación iniciada a partir de recomendaciones sin consultas (íconos más pequeños).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS La app se inicia desde la sección Parental Controls Settings y desde la notificación por app.
APPLICATION_LAUNCH_SOURCE_SHELF La aplicación se inició desde la barra.
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 La aplicación se inició desde una llamada interna de Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD La aplicación se inició desde la combinación de teclas para abrir la aplicación.
APPLICATION_LAUNCH_SOURCE_OTHER_APP La aplicación se inicia cuando se hace clic en un vínculo en otra app o WebUI.
APPLICATION_LAUNCH_SOURCE_MENU Aplicación iniciada desde el menú
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION La aplicación se inició desde la notificación instalada.
APPLICATION_LAUNCH_SOURCE_TEST Se inició la aplicación a partir de una prueba.
APPLICATION_LAUNCH_SOURCE_ARC Se inició la aplicación desde Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Se inició la aplicación desde Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Se inició la aplicación desde la notificación de las notas de la versión.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Se inició la aplicación tras 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 Se inició la aplicación desde una notificación de la pestaña de descubrimiento.
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 Aplicación iniciada 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 Se inició la aplicación desde la URL de un intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN La aplicación se inicia 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 Aplicación iniciada desde el selector de aplicaciones 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 desde el traslado de contenido a una aplicación.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU La aplicación se inicia desde el menú del perfil de la WebUI chrome://password-manager instalable.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR La aplicación se inició desde el calendario de la bandeja del sistema.
APPLICATION_LAUNCH_SOURCE_INSTALLER La aplicación se inició desde el instalador de origen.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Contar los lanzamientos 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 Se lanzó la aplicación en el recorrido de bienvenida.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE La aplicación se inició desde el panel de enfoque.
APPLICATION_LAUNCH_SOURCE_SPARKY La aplicación se lanzó desde la función experimental Sparky.

Métodos

list

 Enumera eventos de telemetría.