REST Resource: customers.telemetry.events

Risorsa: TelemetryEvent

Dati di telemetria registrati da un dispositivo gestito.

Rappresentazione 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)
  }
}
Campi
name

string

Solo output. Nome della risorsa dell'evento.
device

object (TelemetryDeviceInfo)

Solo output. Informazioni sul dispositivo associato all'evento.
user

object (TelemetryUserInfo)

Solo output. Informazioni sull'utente associato all'evento.
reportTime

string (Timestamp format)

Timestamp che rappresenta la data e l'ora in cui è stato registrato l'evento.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

Il tipo di evento corrente.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Solo output. Payload per l'evento di underrun audio grave. Presente solo quando il campo eventType è AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo output. Payload per l'evento relativo alle periferiche USB. Presente solo quando il campo eventType è USB_ADDED o USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo output. Payload per l'evento di modifica dello stato della connessione di rete. Presente solo quando eventType è NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo output. Payload per l'evento di variazione della latenza HTTPS. Presente solo quando eventType è NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo output. Payload per gli eventi di intensità del segnale Wi-Fi. Presente solo quando eventType è WIFI_SIGNAL_STRENGTH_LOW o WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Solo output. Payload per l'evento di modifica dello stato della connessione VPN. Presente solo quando eventType è VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Solo output. Payload per l'evento di installazione dell'app. Presente solo quando eventType è APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Solo output. Payload per l'evento di disinstallazione dell'app. Presente solo quando eventType è APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Solo output. Payload per l'evento di lancio dell'app.Presente solo quando eventType è APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Solo output. Payload per l'evento di arresto anomalo del sistema operativo. Presente solo quando eventType è OS_CRASH.

TelemetryDeviceInfo

Informazioni su un dispositivo associate ai dati di telemetria.

  • Autorizzazione granulare richiesta: TELEMETRY_API_DEVICE
Rappresentazione JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
Campi
deviceId

string

Solo output. L'ID API Directory univoco del dispositivo. Questo valore corrisponde all'ID API Directory della Console di amministrazione nella scheda Dispositivi ChromeOS.
orgUnitId

string

Solo output. ID unità organizzativa del dispositivo.

TelemetryUserInfo

Informazioni su un utente associate ai dati di telemetria.

  • È necessaria l'autorizzazione granulare: TELEMETRY_API_USER
Rappresentazione JSON 
{
  "email": string,
  "orgUnitId": string
}
Campi
email

string

Solo output. L'email dell'utente.
orgUnitId

string

Solo output. ID unità organizzativa dell'utente.

TelemetryAudioSevereUnderrunEvent

Questo tipo non contiene campi.

TelemetryAudioSevereUnderrunEvent viene attivato quando i dati del buffer di un dispositivo audio non sono disponibili per più di 5 secondi.

  • È necessaria l'autorizzazione granulare: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent viene attivato quando vengono aggiunti o rimossi dispositivi USB.

  • Autorizzazione granulare richiesta: TELEMETRY_API_PERIPHERALS_REPORT
Rappresentazione JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Campi
usbPeripheralReport[]

object (UsbPeripheralReport)

Elenco dei dispositivi USB aggiunti o rimossi.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent viene attivato in caso di variazioni dello stato della connessione di rete.

  • Autorizzazione granulare richiesta: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Campi
guid

string

Identificatore univoco della rete.
connectionState

enum (NetworkConnectionState)

Stato attuale della connessione di rete.

TelemetryHttpsLatencyChangeEvent

La routine di latenza HTTPS viene eseguita periodicamente e TelemetryHttpsLatencyChangeEvent viene attivata se viene rilevato un problema di latenza o se il dispositivo si è ripreso da un problema di latenza.

  • Autorizzazione granulare richiesta: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campi
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Dati della routine di latenza HTTPS che ha attivato l'evento.
httpsLatencyState

enum (HttpsLatencyState)

Stato attuale della latenza HTTPS.

HttpsLatencyState

Stato della latenza HTTPS.

Enum
HTTPS_LATENCY_STATE_UNSPECIFIED Lo stato della latenza HTTPS non è specificato.
RECOVERY La latenza HTTPS è tornata normale dopo un problema.
PROBLEM Problema di latenza HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent viene attivato in caso di eventi di intensità del segnale Wi-Fi.

  • Autorizzazione granulare richiesta: TELEMETRY_API_NETWORK_REPORT
Rappresentazione JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Campi
guid

string

Identificatore univoco della rete.
signalStrengthDbm

integer

Valore RSSI dell'intensità del segnale.

TelemetryAppInstallEvent

Dati di installazione delle app.

Rappresentazione JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campi
appInstallSource

enum (ApplicationInstallSource)

Origine di installazione dell'app.
appInstallReason

enum (ApplicationInstallReason)

Motivo dell'installazione dell'app.
appInstallTime

enum (ApplicationInstallTime)

Tempo di installazione dell'app a seconda del ciclo di vita dell'app.
appId

string

ID app. Per le PWA si tratta dell'URL iniziale, mentre per le estensioni si tratta dell'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationInstallSource

Descrive l'origine di installazione dell'app.

Enum
APPLICATION_INSTALL_SOURCE_UNSPECIFIED L'origine di installazione dell'applicazione è sconosciuta.
APPLICATION_INSTALL_SOURCE_SYSTEM Applicazione installata come parte di ChromeOS.
APPLICATION_INSTALL_SOURCE_SYNC L'origine di installazione dell'applicazione è una sincronizzazione.
APPLICATION_INSTALL_SOURCE_PLAY_STORE La sorgente di installazione dell'applicazione è il Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE L'origine dell'installazione dell'applicazione è il Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER L'origine di installazione dell'applicazione è un browser.

ApplicationInstallReason

Descrive il motivo dell'installazione dell'app.

Enum
APPLICATION_INSTALL_REASON_UNSPECIFIED Il motivo dell'installazione dell'applicazione è sconosciuto.
APPLICATION_INSTALL_REASON_SYSTEM Applicazione installata con il sistema ed è considerata parte del sistema operativo.
APPLICATION_INSTALL_REASON_POLICY Applicazione installata in base alle norme.
APPLICATION_INSTALL_REASON_OEM Applicazione installata da un produttore di apparecchiature originali (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Applicazione installata per impostazione predefinita, ma non considerata un'app di sistema.
APPLICATION_INSTALL_REASON_SYNC Applicazione installata tramite sincronizzazione.
APPLICATION_INSTALL_REASON_USER Applicazione installata dall'utente.
APPLICATION_INSTALL_REASON_SUB_APP Applicazione installata tramite chiamata API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Applicazione installata da Kiosk su ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Applicazione installata dall'argomento della riga di comando.

ApplicationInstallTime

Descrive il momento di installazione dell'app in base al suo ciclo di vita.

Enum
APPLICATION_INSTALL_TIME_UNSPECIFIED Ora di installazione dell'applicazione sconosciuta.
APPLICATION_INSTALL_TIME_INIT L'installazione dell'applicazione è stata inizializzata.
APPLICATION_INSTALL_TIME_RUNNING L'installazione dell'applicazione è attualmente in esecuzione.

TelemetryAppUninstallEvent

Dati sulla disinstallazione delle app.

Rappresentazione JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campi
appUninstallSource

enum (ApplicationUninstallSource)

Origine della disinstallazione dell'app.
appId

string

ID app. Per le PWA si tratta dell'URL iniziale, mentre per le estensioni si tratta dell'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationUninstallSource

Descrive l'origine della disinstallazione dell'app.

Enum
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Origine della disinstallazione dell'applicazione sconosciuta.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Applicazione disinstallata dall'elenco delle app (Avvio app).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT L'applicazione è stata disinstallata dalla pagina Gestione app.
APPLICATION_UNINSTALL_SOURCE_SHELF L'applicazione è stata disinstallata dalla sezione App.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Applicazione disinstallata dalla migrazione di app.

TelemetryAppLaunchEvent

Dati sull'avvio delle app.

Rappresentazione JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campi
appLaunchSource

enum (ApplicationLaunchSource)

Origine dell'avvio dell'app.
appId

string

ID app. Per le PWA si tratta dell'URL iniziale, mentre per le estensioni si tratta dell'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationLaunchSource

Descrive l'origine dell'avvio dell'app.

Enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origine dell'avvio dell'applicazione sconosciuta.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID L'applicazione è stata avviata dalla griglia di app, non dalla casella di ricerca.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Applicazione lanciata dalla griglia di app, non dal menu contestuale.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Applicazione lanciata dai risultati dipendenti dalla query (icone più grandi).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Applicazione lanciata dai risultati dipendenti dalla query, non dal menu contestuale.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Applicazione lanciata dai consigli senza query (icone più piccole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Applicazione lanciata dalla sezione Impostazioni del Controllo genitori e notifica del tempo per app.
APPLICATION_LAUNCH_SOURCE_SHELF L'applicazione è stata avviata dalla sezione.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Applicazione lanciata dal gestore dei file
APPLICATION_LAUNCH_SOURCE_OMNIBOX L'applicazione è stata avviata inserendo un URL nell'omnibox del browser.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Applicazione lanciata da una chiamata interna di Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Applicazione avviata dalla scorciatoia da tastiera per l'apertura dell'app.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Applicazione lanciata facendo clic su un link in un'altra app o nell'interfaccia utente web.
APPLICATION_LAUNCH_SOURCE_MENU L'applicazione è stata lanciata dal menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Applicazione lanciata dalla notifica installata.
APPLICATION_LAUNCH_SOURCE_TEST Applicazione lanciata da un test.
APPLICATION_LAUNCH_SOURCE_ARC Applicazione lanciata da Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Applicazione lanciata da Condivisione.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Applicazione lanciata dalla notifica delle note di rilascio.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Applicazione lanciata da un ripristino completo.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Applicazione lanciata da un menu contestuale di selezione di testo intelligente.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Applicazione lanciata da una notifica della scheda Scopri.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Applicazione lanciata dall'API Management.
APPLICATION_LAUNCH_SOURCE_KIOSK L'applicazione è stata avviata dal chiosco.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Applicazione lanciata dalla riga di comando.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE L'applicazione è stata avviata dalla modalità in background.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Applicazione lanciata dalla pagina Nuova scheda.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Applicazione lanciata da un URL intenzione.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN L'applicazione è stata avviata dall'accesso al sistema operativo.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Applicazione lanciata dal gestore di protocollo.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Applicazione lanciata dall'handler URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Applicazione lanciata dall'avvio app della schermata di blocco.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Applicazione lanciata dalla home page dell'app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Applicazione lanciata dal trasferimento di contenuti in un'app.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Applicazione lanciata dal menu del profilo dell'interfaccia utente web installabile chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Applicazione lanciata dal calendario della barra delle app.
APPLICATION_LAUNCH_SOURCE_INSTALLER Applicazione lanciata dall'installatore dell'origine.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Contare separatamente i lanci dell'app Guida alla prima esecuzione per consentirci di comprendere il numero di lanci attivati dall'utente.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR L'applicazione è stata avviata dal tour di benvenuto.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE L'applicazione è stata avviata dal riquadro di messa a fuoco.
APPLICATION_LAUNCH_SOURCE_SPARKY Applicazione lanciata dalla funzionalità sperimentale Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Applicazione lanciata dalla registrazione della navigazione.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Applicazione lanciata dall'API di installazione web.

TelemetryOsCrashEvent

Dati sugli arresti anomali del sistema operativo.

Rappresentazione JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Campi
crashType

enum (CrashType)

Tipo di arresto anomalo.
sessionType

enum (SessionType)

Tipo di sessione.
crashId

string

ID arresto anomalo.

CrashType

Descrive il tipo di arresto anomalo.

Enum
CRASH_TYPE_UNSPECIFIED Tipo di arresto anomalo sconosciuto.
CRASH_TYPE_KERNEL Arresto anomalo del kernel.
CRASH_TYPE_EMBEDDED_CONTROLLER Arresto anomalo del controller incorporato.

SessionType

Descrive il tipo di sessione.

Enum
SESSION_TYPE_UNSPECIFIED Tipo di sessione sconosciuto.
SESSION_TYPE_SIGNED_IN_USER Utente che ha eseguito l'accesso.
SESSION_TYPE_KIOSK Chiosco.
SESSION_TYPE_MANAGED_GUEST Sessione Ospite gestita.
SESSION_TYPE_ACTIVE_DIRECTORY Sessione Active Directory.

Metodi

list

 Elenca gli eventi di telemetria.