REST Resource: customers.telemetry.events

Risorsa: TelemetryEvent

Dati di telemetria segnalati 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 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 nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi 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 evento audio di superamento grave. Presenta solo quando il campo eventType è AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo output. Payload per l'evento 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. Presenta solo quando eventType ha NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Solo output. Payload per l'evento di modifica della latenza HTTPS. Presenta solo quando eventType ha NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Solo output. Payload per gli eventi di intensità del segnale Wi-Fi. Presenta solo quando eventType ha 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. Presenta solo quando eventType ha VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Solo output. Payload per l'evento di installazione di app. Presenta solo quando eventType ha APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

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

TelemetryDeviceInfo

Informazioni su un dispositivo associato ai dati di telemetria.

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

string

Solo output. L'ID univoco dell'API Directory 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 associato ai dati di telemetria.

  • Autorizzazione granulare necessaria: TELEMETRY_API_USER
Rappresentazione JSON 
{
  "email": string,
  "orgUnitId": string
}
Campi
email

string

Solo output. Email dell'utente.
orgUnitId

string

Solo output. ID unità organizzativa dell'utente.

TelemetryAudioSevereUnderrunEvent

Questo tipo non contiene campi.

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

  • Autorizzazione granulare richiesta: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent viene attivato. I dispositivi USB sono stati aggiunti o rimossi.

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

object (UsbPeripheralReport)

Elenco di 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 della rete.

TelemetryHttpsLatencyChangeEvent

La routine di latenza HTTP viene eseguita periodicamente e TelemetryHttpsLatencyChangeEvent viene attivato 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)

I dati della routine di latenza HTTPS che hanno attivato l'evento.
httpsLatencyState

enum (HttpsLatencyState)

Stato attuale di latenza HTTPS.

HttpsLatencyState

di latenza HTTPS.

Enum
HTTPS_LATENCY_STATE_UNSPECIFIED Lo stato di latenza HTTPS non è specificato.
RECOVERY La latenza HTTPS è stata recuperata da 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 sull'installazione delle app.

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

enum (ApplicationInstallSource)

Origine installazione app.
appInstallReason

enum (ApplicationInstallReason)

Motivo dell'installazione dell'app.
appInstallTime

enum (ApplicationInstallTime)

I tempi di installazione delle app dipendono dal ciclo di vita dell'app.
appId

string

ID app. Per le PWA questo è l'URL di inizio e per le estensioni l'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationInstallSource

Descrive l'origine di installazione dell'app.

Enum
APPLICATION_INSTALL_SOURCE_UNSPECIFIED L'origine dell'installazione dell'app è 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 L'origine di installazione dell'app è il Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE L'origine dell'installazione di app è 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 L'applicazione è stata installata con il sistema ed è considerata parte del sistema operativo.
APPLICATION_INSTALL_REASON_POLICY Applicazione installata tramite criterio.
APPLICATION_INSTALL_REASON_OEM Applicazione installata da un produttore di apparecchiature originali (OEM).
APPLICATION_INSTALL_REASON_DEFAULT L'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 per azione dell'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 tempo di installazione dell'app in base al ciclo di vita dell'app.

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 disinstallazione dell'app.
appId

string

ID app. Per le PWA questo è l'URL di inizio e per le estensioni l'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 Applicazione disinstallata dalla pagina Gestione delle app.
APPLICATION_UNINSTALL_SOURCE_SHELF Applicazione disinstallata dalla barra delle app.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Applicazione disinstallata dalla migrazione di app.

TelemetryAppLaunchEvent

Dati relativi al lancio dell'app.

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

enum (ApplicationLaunchSource)

Origine lancio app.
appId

string

ID app. Per le PWA questo è l'URL di inizio e per le estensioni l'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationLaunchSource

Descrive l'origine di avvio dell'app.

Enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origine lancio applicazione sconosciuta.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Applicazione 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 avviata da 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 avviata da suggerimenti senza query (icone più piccole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Applicazione avviata dalla sezione Impostazioni del Controllo genitori e dalla notifica Ora per app.
APPLICATION_LAUNCH_SOURCE_SHELF Applicazione avviata dalla barra delle app.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Applicazione avviata da Gestione 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 avviata dalla scorciatoia da tastiera per l'apertura dell'app.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Applicazione avviata facendo clic su un link in un'altra app o UI web.
APPLICATION_LAUNCH_SOURCE_MENU Applicazione avviata dal menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Applicazione avviata dalla notifica installata.
APPLICATION_LAUNCH_SOURCE_TEST Applicazione avviata da un test.
APPLICATION_LAUNCH_SOURCE_ARC Applicazione avviata da Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Applicazione avviata da Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Applicazione avviata dalla notifica delle note di rilascio.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Applicazione avviata da un ripristino completo.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Applicazione avviata da un menu contestuale di selezione del testo intelligente.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Applicazione avviata da una notifica della scheda Scopri.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Applicazione avviata dall'API di gestione.
APPLICATION_LAUNCH_SOURCE_KIOSK Applicazione avviata da kiosk.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Applicazione avviata dalla riga di comando.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Applicazione 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 Applicazione avviata da OS Login.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Applicazione avviata dal gestore di protocollo.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Applicazione avviata dal gestore di URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Applicazione avviata da Avvio applicazioni della schermata di blocco.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Applicazione avviata dalla pagina della home page dell'app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Applicazione avviata dallo spostamento di contenuti in un'app.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Applicazione avviata 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 avviata dal programma di installazione del codice sorgente.
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 Applicazione avviata dal tour di benvenuto.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Applicazione avviata dal riquadro dello stato attivo.
APPLICATION_LAUNCH_SOURCE_SPARKY Applicazione avviata dalla funzionalità sperimentale Sparky.

Metodi

list

 Elenca gli eventi di telemetria.