REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Telemetriedaten, die von einem verwalteten Gerät erfasst werden.

JSON-Darstellung 
{
  "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)
  }
}
Felder
name

string

Nur Ausgabe. Ressourcenname des Ereignisses.
device

object (TelemetryDeviceInfo)

Nur Ausgabe. Informationen zum Gerät, das mit dem Ereignis verknüpft ist.
user

object (TelemetryUserInfo)

Nur Ausgabe. Informationen zum Nutzer, der mit dem Ereignis verknüpft ist.
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann das Ereignis gemeldet wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

Der Ereignistyp des aktuellen Ereignisses.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Nur Ausgabe. Nutzlast für ein Ereignis mit starkem Unterlauf bei der Audiowiedergabe. Nur vorhanden, wenn das Feld eventType den Wert AUDIO_SEVERE_UNDERRUN hat.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Nur Ausgabe. Nutzlast für USB-Peripheriegeräte-Ereignis. Nur vorhanden, wenn das Feld eventType entweder USB_ADDED oder USB_REMOVED ist.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe. Nutzlast für das Ereignis „Netzwerkverbindungsstatus geändert“. Nur vorhanden, wenn eventType NETWORK_STATE_CHANGE ist.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Nur Ausgabe. Nutzlast für das Ereignis „HTTPS-Latenzänderung“. Nur vorhanden, wenn eventType NETWORK_HTTPS_LATENCY_CHANGE ist.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Nur Ausgabe. Nutzlast für WLAN-Signalstärkeereignisse. Nur vorhanden, wenn eventType WIFI_SIGNAL_STRENGTH_LOW oder WIFI_SIGNAL_STRENGTH_RECOVERED ist.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe. Nutzlast für das Ereignis „Änderung des VPN-Verbindungsstatus“. Nur vorhanden, wenn eventType VPN_CONNECTION_STATE_CHANGE ist.
appInstallEvent

object (TelemetryAppInstallEvent)

Nur Ausgabe. Nutzlast für das Ereignis „App-Installation“. Nur vorhanden, wenn eventType APP_INSTALLED ist.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Nur Ausgabe. Nutzlast für das Ereignis „App-Deinstallation“. Nur vorhanden, wenn eventType APP_UNINSTALLED ist.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Nur Ausgabe. Nutzlast für das Ereignis „App-Start“. Ist nur vorhanden, wenn eventType APP_LAUNCHED ist.
osCrashEvent

object (TelemetryOsCrashEvent)

Nur Ausgabe. Nutzlast für Betriebssystemabsturzereignisse. Nur vorhanden, wenn eventType OS_CRASH ist.

TelemetryDeviceInfo

Informationen zu einem Gerät, die mit Telemetriedaten verknüpft sind.

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_DEVICE
JSON-Darstellung 
{
  "deviceId": string,
  "orgUnitId": string
}
Felder
deviceId

string

Nur Ausgabe. Die eindeutige Directory API-ID des Geräts. Dieser Wert entspricht der Directory API-ID der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.
orgUnitId

string

Nur Ausgabe. Die ID der Organisationseinheit des Geräts.

TelemetryUserInfo

Informationen zu einem Nutzer, die mit Telemetriedaten verknüpft sind.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_USER
JSON-Darstellung 
{
  "email": string,
  "orgUnitId": string
}
Felder
email

string

Nur Ausgabe. E-Mail-Adresse des Nutzers.
orgUnitId

string

Nur Ausgabe. Die Organisationseinheits-ID des Nutzers.

TelemetryAudioSevereUnderrunEvent

Dieser Typ hat keine Felder.

TelemetryAudioSevereUnderrunEvent wird ausgelöst, wenn bei einem Audiogerät mehr als 5 Sekunden lang keine Pufferdaten mehr verfügbar sind.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Wenn TelemetryUsbPeripheralsEvent ausgelöst wird, werden USB-Geräte entweder hinzugefügt oder entfernt.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_PERIPHERALS_REPORT
JSON-Darstellung 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Felder
usbPeripheralReport[]

object (UsbPeripheralReport)

Liste der USB-Geräte, die hinzugefügt oder entfernt wurden.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent wird bei Änderungen des Netzwerkverbindungsstatus ausgelöst.

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Felder
guid

string

Eindeutige Kennung des Netzwerks.
connectionState

enum (NetworkConnectionState)

Aktueller Verbindungsstatus des Netzwerks.

TelemetryHttpsLatencyChangeEvent

Der Https-Latenzroutine wird regelmäßig ausgeführt und TelemetryHttpsLatencyChangeEvent wird ausgelöst, wenn ein Latenzproblem erkannt wurde oder das Gerät sich von einem Latenzproblem erholt hat.

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Felder
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Daten zur HTTPS-Latenzroutine, die das Ereignis ausgelöst haben.
httpsLatencyState

enum (HttpsLatencyState)

Aktueller Status der HTTPS-Latenz.

HttpsLatencyState

HTTPS-Latenzstatus

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED Der HTTPS-Latenzstatus ist nicht angegeben.
RECOVERY Die HTTPS-Latenz ist nach einem Problem wiederhergestellt.
PROBLEM HTTPS-Latenzproblem.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent wird bei WLAN-Signalstärkeereignissen ausgelöst.

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Felder
guid

string

Eindeutige Kennung des Netzwerks.
signalStrengthDbm

integer

RSSI-Wert der Signalstärke.

TelemetryAppInstallEvent

Daten zu App-Installationen.

JSON-Darstellung 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Felder
appInstallSource

enum (ApplicationInstallSource)

Quelle der App-Installation.
appInstallReason

enum (ApplicationInstallReason)

Grund für die App-Installation.
appInstallTime

enum (ApplicationInstallTime)

Die App-Installationszeit hängt vom App-Lebenszyklus ab.
appId

string

App-ID Bei PWAs ist dies die Start-URL und bei Erweiterungen die Erweiterungs-ID.
appType

enum (TelemetryApplicationType)

App-Typ

ApplicationInstallSource

Beschreibt die Quelle der App-Installation.

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Die Installationsquelle der Anwendung ist unbekannt.
APPLICATION_INSTALL_SOURCE_SYSTEM Im Rahmen von ChromeOS installierte Anwendung.
APPLICATION_INSTALL_SOURCE_SYNC Die Quelle für die Installation der Anwendung ist eine Synchronisierung.
APPLICATION_INSTALL_SOURCE_PLAY_STORE Die Installationsquelle der App ist der Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE Die Installationsquelle der Anwendung ist der Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER Die Installationsquelle der Anwendung ist ein Browser.

ApplicationInstallReason

Beschreibt den Grund für die Installation der App.

Enums
APPLICATION_INSTALL_REASON_UNSPECIFIED Der Grund für die Installation der Anwendung ist unbekannt.
APPLICATION_INSTALL_REASON_SYSTEM Eine Anwendung, die mit dem System installiert wurde und als Teil des Betriebssystems gilt.
APPLICATION_INSTALL_REASON_POLICY Von der Richtlinie installierte Anwendung
APPLICATION_INSTALL_REASON_OEM Von einem Erstausrüster (Original Equipment Manufacturer, OEM) installierte Anwendung.
APPLICATION_INSTALL_REASON_DEFAULT Eine standardmäßig installierte App, die nicht als System-App gilt.
APPLICATION_INSTALL_REASON_SYNC Über die Synchronisierung installierte App.
APPLICATION_INSTALL_REASON_USER Anwendung, die durch Nutzeraktion installiert wurde.
APPLICATION_INSTALL_REASON_SUB_APP Anwendung, die über den SubApp API-Aufruf installiert wurde.
APPLICATION_INSTALL_REASON_KIOSK Von Kiosk auf ChromeOS installierte Anwendung.
APPLICATION_INSTALL_REASON_COMMAND_LINE Anwendung, die über ein Befehlszeilenargument installiert wurde.

ApplicationInstallTime

Gibt die Installationszeit der App je nach App-Lebenszyklus an.

Enums
APPLICATION_INSTALL_TIME_UNSPECIFIED Installationszeit der Anwendung unbekannt.
APPLICATION_INSTALL_TIME_INIT Die Installation der Anwendung wird initialisiert.
APPLICATION_INSTALL_TIME_RUNNING Die Installation der Anwendung wird gerade ausgeführt.

TelemetryAppUninstallEvent

Daten zur App-Deinstallation

JSON-Darstellung 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Felder
appUninstallSource

enum (ApplicationUninstallSource)

Quelle der App-Deinstallation.
appId

string

App-ID Bei PWAs ist dies die Start-URL und bei Erweiterungen die Erweiterungs-ID.
appType

enum (TelemetryApplicationType)

App-Typ

ApplicationUninstallSource

Beschreibt die Quelle der App-Deinstallation.

Enums
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Quelle der App-Deinstallation unbekannt.
APPLICATION_UNINSTALL_SOURCE_APP_LIST App wurde aus der App-Liste (Launcher) deinstalliert.
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Die Anwendung wurde auf der Seite „App-Verwaltung“ deinstalliert.
APPLICATION_UNINSTALL_SOURCE_SHELF App wurde aus der Ablage deinstalliert.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Die App wurde durch die App-Migration deinstalliert.

TelemetryAppLaunchEvent

Daten zum App-Start

JSON-Darstellung 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Felder
appLaunchSource

enum (ApplicationLaunchSource)

Quelle für den App-Start.
appId

string

App-ID Bei PWAs ist dies die Start-URL und bei Erweiterungen die Erweiterungs-ID.
appType

enum (TelemetryApplicationType)

App-Typ

ApplicationLaunchSource

Beschreibt die Quelle, über die die App gestartet wurde.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Quelle für den App-Start unbekannt.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Die App wurde über das App-Raster und nicht über das Suchfeld gestartet.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Anwendung, die über das App-Raster und nicht über das Kontextmenü gestartet wird.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Anwendung, die über abfrageabhängige Ergebnisse gestartet wird (größere Symbole)
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Anwendung, die über abfrageabhängige Ergebnisse gestartet wird, nicht über das Kontextmenü.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION App, die über Empfehlungen ohne Suchanfrage gestartet wurde (kleinere Symbole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS App, die über die Jugendschutzeinstellungen gestartet wurde, und Benachrichtigung zur Nutzungsdauer pro App
APPLICATION_LAUNCH_SOURCE_SHELF Anwendung wurde über die Ablage gestartet.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Anwendung, die über den Dateimanager gestartet wird
APPLICATION_LAUNCH_SOURCE_OMNIBOX Die Anwendung wird gestartet, indem eine URL in die Omnibox des Browsers eingegeben wird.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Anwendung, die über einen internen Chrome-Aufruf gestartet wurde.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Anwendung, die über eine Tastenkombination gestartet wird
APPLICATION_LAUNCH_SOURCE_OTHER_APP Die Anwendung wird gestartet, wenn auf einen Link in einer anderen App oder Web-Benutzeroberfläche geklickt wird.
APPLICATION_LAUNCH_SOURCE_MENU Die Anwendung wird über das Menü gestartet.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Die Anwendung wurde über die installierte Benachrichtigung gestartet.
APPLICATION_LAUNCH_SOURCE_TEST Die Anwendung wurde über einen Test gestartet.
APPLICATION_LAUNCH_SOURCE_ARC Anwendung, die über Arc gestartet wurde
APPLICATION_LAUNCH_SOURCE_SHARESHEET Anwendung, die über das Freigabe-Menü gestartet wurde
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Die Anwendung wurde über die Benachrichtigung mit den Versionshinweisen gestartet.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Anwendung, die nach einer vollständigen Wiederherstellung gestartet wurde.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Anwendung, die über ein Kontextmenü für die intelligente Textauswahl gestartet wurde.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Anwendung, die über eine Benachrichtigung auf dem Tab „Entdecken“ gestartet wurde.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Anwendung, die über die Management API gestartet wurde.
APPLICATION_LAUNCH_SOURCE_KIOSK Anwendung wurde über den Kiosk gestartet.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Anwendung, die über die Befehlszeile gestartet wird.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Die Anwendung wurde aus dem Hintergrundmodus gestartet.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Anwendung, die über die Seite „Neuer Tab“ gestartet wird.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Anwendung, die über eine Intent-URL gestartet wurde.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Die Anwendung wurde über OS Login gestartet.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Anwendung, die über den Protokoll-Handler gestartet wird.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Anwendung, die über den URL-Handler gestartet wird.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN App, die über den App Launcher auf dem Sperrbildschirm gestartet wurde.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Die App wurde über die Startseite der App (chrome://apps) gestartet.
APPLICATION_LAUNCH_SOURCE_REPARENTING Anwendung, die durch Verschieben von Inhalten in eine App gestartet wird.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Die Anwendung wird über das Profilmenü der installierbaren Webanwendung chrome://password-manager gestartet.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Anwendung, die über den Kalender in der Taskleiste gestartet wurde.
APPLICATION_LAUNCH_SOURCE_INSTALLER Anwendung, die über den Quell-Installationsmedium gestartet wird.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Zählen Sie die ersten Starts der Hilfe-App separat, damit wir die Anzahl der von Nutzern ausgelösten Starts nachvollziehen können.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Die Anwendung wurde über die Begrüßungstour gestartet.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Anwendung, die über den Fokusbereich gestartet wurde
APPLICATION_LAUNCH_SOURCE_SPARKY Anwendung, die über die experimentelle Funktion „Sparky“ gestartet wurde
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Anwendung, die über die Navigationsaufzeichnung gestartet wurde.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Anwendung, die über die Web Install API gestartet wurde.

TelemetryOsCrashEvent

Daten zu Betriebssystemabstürzen

JSON-Darstellung 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Felder
crashType

enum (CrashType)

Art des Absturzes.
sessionType

enum (SessionType)

Sitzungstyp.
crashId

string

Absturz-ID

CrashType

Beschreibt den Absturztyp.

Enums
CRASH_TYPE_UNSPECIFIED Art des Absturzes unbekannt.
CRASH_TYPE_KERNEL Kernel-Absturz.
CRASH_TYPE_EMBEDDED_CONTROLLER Eingebetteter Controller stürzt ab.

SessionType

Beschreibt den Sitzungstyp.

Enums
SESSION_TYPE_UNSPECIFIED Sitzungstyp unbekannt.
SESSION_TYPE_SIGNED_IN_USER Angemeldeter Nutzer
SESSION_TYPE_KIOSK Kiosk.
SESSION_TYPE_MANAGED_GUEST Verwaltete Gastsitzung.
SESSION_TYPE_ACTIVE_DIRECTORY Active Directory-Sitzung.

Methoden

list

 Telemetrieereignisse auflisten