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 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 il momento in cui l'evento è stato segnalato.

Un timestamp in formato "Zulu" RFC3339 UTC, 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 corrente.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Solo output. Payload per evento audio grave di sottoesecuzione. Presenta solo quando il campo eventType è AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Solo output. Payload per evento di periferiche USB. Presenta 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 è NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

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

object (TelemetryNetworkSignalStrengthEvent)

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

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

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

TelemetryDeviceInfo

Informazioni su un dispositivo associato ai dati di telemetria.

  • Autorizzazione granulare necessaria: 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.

La funzionalità TelemetryAudioSevereUnderrunEvent viene attivata quando un dispositivo audio esaurisce i dati del buffer per più di 5 secondi.

  • Autorizzazione granulare necessaria: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

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

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

object (UsbPeripheralReport)

Elenco dei dispositivi USB aggiunti o rimossi.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent viene attivato alle modifiche dello stato della connessione di rete.

  • Autorizzazione granulare necessaria: 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 HTTPS viene eseguita periodicamente e l'opzione TelemetryHttpsLatencyChangeEvent viene attivata se è stato rilevato un problema di latenza o se il dispositivo si è ripristinato da un problema di latenza.

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

object (HttpsLatencyRoutineData)

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

enum (HttpsLatencyState)

Stato di latenza HTTPS attuale.

HttpsLatencyState

Stato della latenza HTTPS.

Enum
HTTPS_LATENCY_STATE_UNSPECIFIED Lo stato di latenza HTTPS non è specificato.
RECOVERY Latenza HTTPS recuperata da un problema.
PROBLEM Problema di latenza HTTPS.

TelemetryNetworkSignalStrengthEvent

L'opzione TelemetryNetworkSignalStrengthEvent viene attivata in caso di eventi di intensità del segnale Wi-Fi.

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

string

Identificatore univoco della rete.
signalStrengthDbm

integer

Valore RSSI di 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 dell'installazione dell'app.
appInstallReason

enum (ApplicationInstallReason)

Motivo dell'installazione dell'app.
appInstallTime

enum (ApplicationInstallTime)

Tempo di installazione dell'app in base al ciclo di vita dell'app.
appId

string

ID app. Per le PWA, si tratta dell'URL di avvio e per le estensioni l'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationInstallSource

Descrive l'origine dell'installazione dell'app.

Enum
APPLICATION_INSTALL_SOURCE_UNSPECIFIED 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 L'origine di installazione dell'app è il Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE L'origine di installazione dell'applicazione è 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 di installazione dell'applicazione sconosciuto.
APPLICATION_INSTALL_REASON_SYSTEM L'applicazione è installata con il sistema ed è considerata parte del sistema operativo.
APPLICATION_INSTALL_REASON_POLICY Applicazione installata in base al criterio.
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 come un'app di sistema.
APPLICATION_INSTALL_REASON_SYNC Applicazione installata tramite sincronizzazione.
APPLICATION_INSTALL_REASON_USER Applicazione installata in base all'azione dell'utente.
APPLICATION_INSTALL_REASON_SUB_APP Applicazione installata bt 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 sulle disinstallazioni dell'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 di avvio 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 di 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 app.
APPLICATION_UNINSTALL_SOURCE_SHELF Applicazione disinstallata dalla barra delle app.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Applicazione disinstallata tramite migrazione delle app.

TelemetryAppLaunchEvent

Dati relativi al lancio dell'app.

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

enum (ApplicationLaunchSource)

Origine di lancio dell'app.
appId

string

ID app. Per le PWA, si tratta dell'URL di avvio e per le estensioni l'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationLaunchSource

Descrive l'origine di lancio dell'app.

Enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origine di avvio dell'applicazione sconosciuta.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Applicazione avviata dalla griglia delle app, non dalla casella di ricerca.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Applicazione avviata dalla griglia di app, al di fuori del menu contestuale.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Applicazione avviata dai risultati dipendenti dalla query (icone più grandi).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Applicazione avviata dai risultati dipendenti dalla query, al di fuori del menu contestuale.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Applicazione avviata dai suggerimenti senza query (icone più piccole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Applicazione avviata dalla sezione delle impostazioni del Controllo genitori e dalla notifica relativa al tempo 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 dopo l'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 dopo aver fatto 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 di installazione.
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 intelligente del testo.
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 dal 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 app della schermata di blocco.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Applicazione avviata dalla home page dell'app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Applicazione lanciata 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 di origine.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Conteggia separatamente gli avvii delle app di assistenza alla prima esecuzione per consentirci di conoscere 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 attivo.

Metodi

list

 Elenca gli eventi di telemetria.