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)
  }
}
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 quando è stato segnalato l'evento.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

Il tipo di evento attuale.
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. Presenta solo quando eventType ha 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.

TelemetryDeviceInfo

Informazioni su un dispositivo associato ai dati di telemetria.

  • È necessaria l'autorizzazione granulare 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.

  • Autorizzazione granulare richiesta: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent viene attivato quando i dispositivi USB vengono aggiunti o rimossi.

  • È necessaria l'autorizzazione granulare: TELEMETRY_API_PERIPHERALS_REPORT
Rappresentazione JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Campi
usbPeripheralReport[]

object (UsbPeripheralReport)

Elenco dei dispositivi USB aggiunti o rimossi.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent viene attivato quando lo stato della connessione di rete viene modificato.

  • 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 per gli 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 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 tramite 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 corso.

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 disinstallazione dell'applicazione sconosciuta.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Applicazione disinstallata dall'Elenco di app (Avvio app).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT L'applicazione è stata disinstallata dalla pagina Gestione app.
APPLICATION_UNINSTALL_SOURCE_SHELF Applicazione disinstallata dalla barra delle app.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Applicazione disinstallata dalla migrazione di app.

TelemetryAppLaunchEvent

Dati relativi all'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 di 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 avviata dalla griglia di app, fuori 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 avviata da risultati dipendenti dalla query, fuori 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 Applicazione avviata dalla barra delle app.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Applicazione lanciata dal gestore file
APPLICATION_LAUNCH_SOURCE_OMNIBOX Applicazione avviata dall'inserimento di un URL nella omnibox sul browser.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Applicazione avviata da una chiamata interna di Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Applicazione lanciata 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 avviata dal menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Applicazione lanciata dalla notifica installata.
APPLICATION_LAUNCH_SOURCE_TEST Applicazione avviata da un test.
APPLICATION_LAUNCH_SOURCE_ARC Applicazione lanciata da Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Applicazione lanciata dalla scheda 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 avviata da una notifica della scheda Scopri.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Applicazione lanciata dall'API Management.
APPLICATION_LAUNCH_SOURCE_KIOSK Applicazione avviata da kiosk.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Applicazione avviata dalla riga di comando.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE L'applicazione è stata avviata dalla modalità in background.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Applicazione avviata dalla pagina Nuova scheda.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Applicazione avviata da un URL di intent.
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 avviata dal calendario della barra delle applicazioni.
APPLICATION_LAUNCH_SOURCE_INSTALLER Applicazione lanciata dall'installatore dell'origine.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Conteggia separatamente i lanci dell'app della guida alla prima esecuzione in modo da poter capire 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 Applicazione avviata dal riquadro di messa a fuoco.
APPLICATION_LAUNCH_SOURCE_SPARKY Applicazione avviata dalla funzionalità sperimentale Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Applicazione lanciata dalla registrazione della navigazione.

Metodi

list

 Elenca gli eventi di telemetria.