REST Resource: customers.telemetry.events

Recurso: TelemetryEvent

Son los datos de telemetría que informa 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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso del evento.
device

object (TelemetryDeviceInfo)

Solo salida. Es información sobre el dispositivo asociado al evento.
user

object (TelemetryUserInfo)

Solo salida. Es información sobre el usuario asociado al evento.
reportTime

string (Timestamp format)

Es la marca de tiempo que representa cuándo se informó el evento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “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 subejecución grave de audio. Solo está presente cuando el campo eventType es AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo salida. Es la carga útil del evento de periféricos USB. Solo está presente cuando el campo eventType es USB_ADDED o USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo salida. Es la carga útil del 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. Es la carga útil del evento de cambio de latencia de HTTPS. Solo está presente cuando eventType es NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo salida. Es la carga útil para los 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. Es la carga útil del evento de cambio de estado de la conexión VPN. Solo está presente cuando eventType es VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Solo salida. Es la carga útil del evento de instalación de la app. Solo está presente cuando eventType es APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Solo salida. Es la carga útil del evento de desinstalación de la app. Solo está presente cuando eventType es APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Solo salida. Es la carga útil del evento de inicio de la app, que solo está presente cuando eventType es APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Solo salida. Es la carga útil del evento de falla del SO. Solo está presente cuando eventType es OS_CRASH.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Solo salida. Es la carga útil del evento de conexión o desconexión de la pantalla externa. Solo está presente cuando eventType es EXTERNAL_DISPLAY_CONNECTED o EXTERNAL_DISPLAY_DISCONNECTED.

TelemetryDeviceInfo

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

  • Permiso detallado necesario: 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

Es información sobre un usuario asociada a 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. ID de la unidad organizativa del usuario.

TelemetryAudioSevereUnderrunEvent

Este tipo no tiene campos.

TelemetryAudioSevereUnderrunEvent se activa cuando los dispositivos de audio se quedan 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 el 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 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 el permiso detallado: 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)

Es el estado actual de latencia de HTTPS.

HttpsLatencyState

Es el estado de latencia de HTTPS.

Enums
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 el 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

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

TelemetryAppInstallEvent

Son los 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)

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

Es el tipo de app.

ApplicationInstallSource

Describe la fuente de instalación de la app.

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Se desconoce la fuente de instalación de la aplicación.
APPLICATION_INSTALL_SOURCE_SYSTEM Es una 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 la instalación de la app.

Enums
APPLICATION_INSTALL_REASON_UNSPECIFIED Se desconoce el motivo de la instalación de la aplicación.
APPLICATION_INSTALL_REASON_SYSTEM La aplicación se instaló con el sistema y se considera parte del SO.
APPLICATION_INSTALL_REASON_POLICY La aplicación se instaló por política.
APPLICATION_INSTALL_REASON_OEM Aplicación instalada por un fabricante de equipos originales (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 Es la aplicación instalada por la llamada a la API de SubApp.
APPLICATION_INSTALL_REASON_KIOSK Es la aplicación que instaló el kiosco en ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Es la aplicación instalada por el argumento de la línea de comandos.

ApplicationInstallTime

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

Enums
APPLICATION_INSTALL_TIME_UNSPECIFIED Se desconoce el tiempo de instalación de la aplicación.
APPLICATION_INSTALL_TIME_INIT Se inicializó la instalación de la aplicación.
APPLICATION_INSTALL_TIME_RUNNING Actualmente, se está instalando la aplicación.

TelemetryAppUninstallEvent

Son los datos de desinstalación de la app.

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

enum (ApplicationUninstallSource)

Es la fuente de desinstalación de la app.
appId

string

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)

Es el tipo de app.

ApplicationUninstallSource

Describe la fuente de desinstalación de la app.

Enums
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 desde la página Administración de aplicaciones.
APPLICATION_UNINSTALL_SOURCE_SHELF Se desinstaló la aplicación de la biblioteca.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Se desinstaló la aplicación debido a la migración de la app.

TelemetryAppLaunchEvent

Datos de lanzamiento 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. 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)

Es el tipo de app.

ApplicationLaunchSource

Describe la fuente de inicio de la app.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Se desconoce la fuente de inicio de la aplicación.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID La aplicación se inició desde la cuadrícula de aplicaciones, no desde el cuadro de búsqueda.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Se inició la aplicación desde la cuadrícula de apps, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Se inició la aplicación desde resultados dependientes de la búsqueda (íconos más grandes).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU La aplicación se inicia desde los resultados que dependen de la búsqueda, fuera del menú contextual.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Se inició la aplicación desde recomendaciones sin búsqueda (íconos más pequeños).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Se lanzó la aplicación desde la sección Configuración de los 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 La aplicación se inició 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 inició con la combinación de teclas para abrirla.
APPLICATION_LAUNCH_SOURCE_OTHER_APP La aplicación se inició cuando se hizo 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 La aplicación se inició desde la notificación instalada.
APPLICATION_LAUNCH_SOURCE_TEST Se inició la aplicación desde una prueba.
APPLICATION_LAUNCH_SOURCE_ARC Se inició la aplicación desde Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Se inició la aplicación desde la hoja para compartir.
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 una restauración completa.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Es una aplicación que se inicia 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 Explorar.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Es la aplicación que se inicia 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 Se inició la aplicación desde el modo en segundo plano.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Se lanzó la aplicación desde la página Nueva pestaña.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Se lanzó la aplicación 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 Se inició la aplicación desde el controlador de protocolos.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Se inició la aplicación desde el controlador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Se inició la aplicación desde el selector de apps de la pantalla de bloqueo.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Se lanzó la aplicación desde la página principal de la app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplicación iniciada desde contenido en movimiento hacia 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 Se inició la aplicación 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 Contamos los inicios de la app de Ayuda en la primera ejecución por separado para comprender la cantidad de inicios activados por el usuario.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Se inició la aplicación desde el recorrido de bienvenida.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Se inició la aplicación desde el panel de enfoque.
APPLICATION_LAUNCH_SOURCE_SPARKY Se inició la aplicación desde la función experimental Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Aplicación iniciada desde la captura de navegación.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Es la aplicación que se inició 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)

Es el tipo de accidente.
sessionType

enum (SessionType)

Es el tipo de sesión.
crashId

string

ID de la falla.

CrashType

Describe el tipo de falla.

Enums
CRASH_TYPE_UNSPECIFIED Se desconoce el tipo de falla.
CRASH_TYPE_KERNEL Se produjo una falla en el kernel.
CRASH_TYPE_EMBEDDED_CONTROLLER Se produjo una falla en el controlador incorporado.

SessionType

Describe el tipo de sesión.

Enums
SESSION_TYPE_UNSPECIFIED Tipo de sesión desconocido.
SESSION_TYPE_SIGNED_IN_USER Es el 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

TelemetryExternalDisplayEvent

Es la carga útil del evento de conexión o desconexión de la pantalla externa.

Representación JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Campos
externalDisplayData[]

object (TelemetryExternalDisplayData)

Es la lista de pantallas externas que se conectaron o desconectaron.

TelemetryExternalDisplayData

Son los datos de la pantalla externa.

Representación JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Campos
displayName

string

Es el nombre visible.
resolutionHorizontal

integer

Resolución horizontal.
resolutionVertical

integer

Resolución vertical.
refreshRate

string (int64 format)

Es la frecuencia de actualización.
serialNumber

integer

Es el número de serie.
edidVersion

string

Es la versión de EDID.

Métodos

list

 Enumera los eventos de telemetría.