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)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
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 indica quando è stato segnalato l'evento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 dell'evento corrente.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

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

object (TelemetryUsbPeripheralsEvent)

Solo output. Payload per l'evento delle 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 modifica 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 avvio 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.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Solo output. Payload per l'evento di connessione/disconnessione del display esterno. Presente solo quando eventType è EXTERNAL_DISPLAY_CONNECTED o EXTERNAL_DISPLAY_DISCONNECTED.

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 API Directory univoco del dispositivo. Questo valore corrisponde all'ID API Directory della Console di amministrazione nella scheda Dispositivi ChromeOS.
orgUnitId

string

Solo output. L'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. L'ID unità organizzativa dell'utente.

TelemetryAudioSevereUnderrunEvent

Questo tipo non contiene campi.

TelemetryAudioSevereUnderrunEvent viene attivato quando i dispositivi audio esauriscono i dati del buffer per più di 5 secondi.

  • Autorizzazione granulare necessaria: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent viene attivato quando vengono aggiunti o rimossi dispositivi USB.

  • 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 in caso di modifiche allo 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 di rete.

TelemetryHttpsLatencyChangeEvent

La routine di latenza HTTPS viene eseguita periodicamente e TelemetryHttpsLatencyChangeEvent viene attivato se è stato rilevato un problema di latenza o se il dispositivo ha risolto 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 ha attivato l'evento.
httpsLatencyState

enum (HttpsLatencyState)

Stato attuale della latenza HTTPS.

HttpsLatencyState

Stato della 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 base agli 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 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, questo è l'URL di avvio, mentre 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 L'origine dell'installazione dell'applicazione è sconosciuta.
APPLICATION_INSTALL_SOURCE_SYSTEM Applicazione installata come parte di ChromeOS.
APPLICATION_INSTALL_SOURCE_SYNC L'origine dell'installazione dell'applicazione è una sincronizzazione.
APPLICATION_INSTALL_SOURCE_PLAY_STORE L'origine dell'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 e 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 la sincronizzazione.
APPLICATION_INSTALL_REASON_USER Applicazione installata tramite azione dell'utente.
APPLICATION_INSTALL_REASON_SUB_APP Applicazione installata dalla chiamata API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Applicazione installata da Kiosk su ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Applicazione installata tramite l'argomento della riga di comando.

ApplicationInstallTime

Descrive il tempo di installazione dell'app a seconda del ciclo di vita dell'app.

Enum
APPLICATION_INSTALL_TIME_UNSPECIFIED Tempo di installazione dell'applicazione sconosciuto.
APPLICATION_INSTALL_TIME_INIT L'installazione dell'applicazione è stata inizializzata.
APPLICATION_INSTALL_TIME_RUNNING L'installazione dell'applicazione è attualmente in corso.

TelemetryAppUninstallEvent

Dati di disinstallazione delle app.

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

enum (ApplicationUninstallSource)

Origine di disinstallazione dell'app.
appId

string

ID app. Per le PWA, questo è l'URL di avvio, mentre 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 della disinstallazione dell'applicazione sconosciuta.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Applicazione disinstallata dall'elenco delle app (Avvio app).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Applicazione disinstallata dalla pagina Gestione app.
APPLICATION_UNINSTALL_SOURCE_SHELF L'applicazione è stata disinstallata dallo scaffale.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Applicazione disinstallata tramite la migrazione delle app.

TelemetryAppLaunchEvent

Dati di avvio delle app.

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

enum (ApplicationLaunchSource)

Origine di avvio dell'app.
appId

string

ID app. Per le PWA, questo è l'URL di avvio, mentre per le estensioni è l'ID estensione.
appType

enum (TelemetryApplicationType)

Tipo di app.

ApplicationLaunchSource

Descrive l'origine del lancio dell'app.

Enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origine dell'avvio dell'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, dal 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, dal menu contestuale.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Applicazione avviata da consigli senza query (icone più piccole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Applicazione avviata 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 avviata da gestore di file
APPLICATION_LAUNCH_SOURCE_OMNIBOX Applicazione avviata inserendo un URL nell'omnibox del 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 interfaccia utente 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 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 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 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 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 dell'origine.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Conta separatamente gli avvii dell'app Guida alla prima esecuzione in modo da poter comprendere il numero di avvii attivati dagli utenti.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Applicazione avviata dal tour di benvenuto.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Applicazione avviata dal riquadro di messa a fuoco.
APPLICATION_LAUNCH_SOURCE_SPARKY Applicazione lanciata dalla funzionalità sperimentale Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Applicazione avviata dall'acquisizione della navigazione.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Applicazione avviata dall'API Web Install.

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 di Active Directory.

TelemetryExternalDisplayEvent

Payload dell'evento di connessione/disconnessione del display esterno.

Rappresentazione JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Campi
externalDisplayData[]

object (TelemetryExternalDisplayData)

Elenco dei display esterni che sono stati collegati/scollegati.

TelemetryExternalDisplayData

Dati del display esterno.

Rappresentazione JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Campi
displayName

string

Il nome visualizzato.
resolutionHorizontal

integer

La risoluzione orizzontale.
resolutionVertical

integer

La risoluzione verticale.
refreshRate

string (int64 format)

La frequenza di aggiornamento.
serialNumber

integer

Il numero di serie.
edidVersion

string

La versione EDID.

Metodi

list

 Elenca gli eventi di telemetria.