REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Telemetriedaten, die von einem verwalteten Gerät gemeldet 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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. 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 das Ereignis „Audio Severe Underrun“. Nur vorhanden, wenn das Feld eventType AUDIO_SEVERE_UNDERRUN ist.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe. Nutzlast für das Ereignis zur Änderung des Netzwerkverbindungsstatus. Wird nur angezeigt, wenn eventType NETWORK_STATE_CHANGE ist.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Nur Ausgabe. Nutzlast für das Ereignis zur Änderung der HTTPS-Latenz. Wird nur angezeigt, wenn eventType NETWORK_HTTPS_LATENCY_CHANGE ist.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Nur Ausgabe. Nutzlast für Ereignisse zur WLAN-Signalstärke. 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“. Wird nur angezeigt, wenn eventType VPN_CONNECTION_STATE_CHANGE ist.
appInstallEvent

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

Nur Ausgabe. Nutzlast für das Ereignis zum Starten der App.Nur vorhanden, wenn eventType gleich APP_LAUNCHED ist.
osCrashEvent

object (TelemetryOsCrashEvent)

Nur Ausgabe. Nutzlast für Betriebssystemabsturzereignis. Wird nur angezeigt, wenn eventType OS_CRASH ist.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Nur Ausgabe. Nutzlast für das Ereignis „Externes Display verbunden/getrennt“. Nur vorhanden, wenn eventType EXTERNAL_DISPLAY_CONNECTED oder EXTERNAL_DISPLAY_DISCONNECTED ist.

TelemetryDeviceInfo

Informationen zu einem Gerät, das mit Telemetriedaten verknüpft ist.

  • 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 in der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.
orgUnitId

string

Nur Ausgabe. ID der Organisationseinheit des Geräts.

TelemetryUserInfo

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

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_USER
JSON-Darstellung 
{
  "email": string,
  "orgUnitId": string
}
Felder
email

string

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

string

Nur Ausgabe. Die ID der Organisationseinheit des Nutzers.

TelemetryAudioSevereUnderrunEvent

Dieser Typ hat keine Felder.

TelemetryAudioSevereUnderrunEvent wird ausgelöst, wenn einem Audiogerät länger als 5 Sekunden lang keine Pufferdaten mehr zur Verfügung stehen.

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

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

  • Erforderliche detaillierte Berechtigung: 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

Die Https-Latenzroutine wird regelmäßig ausgeführt und TelemetryHttpsLatencyChangeEvent wird ausgelöst, wenn ein Latenzproblem erkannt wurde oder wenn 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)

HTTPS-Latenzroutinedaten, die das Ereignis ausgelöst haben.
httpsLatencyState

enum (HttpsLatencyState)

Aktueller HTTPS-Latenzstatus.

HttpsLatencyState

HTTPS-Latenzstatus.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED Der HTTPS-Latenzstatus ist nicht angegeben.
RECOVERY Die HTTPS-Latenz hat sich nach einem Problem wieder normalisiert.
PROBLEM HTTPS-Latenzproblem.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent wird bei Ereignissen zur WLAN-Signalstärke 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 zur App-Installation.

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 Installationszeit der App hängt vom App-Lebenszyklus ab.
appId

string

App-ID Bei PWAs ist das 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 App ist unbekannt.
APPLICATION_INSTALL_SOURCE_SYSTEM Die Anwendung ist als Teil von Chrome OS installiert.
APPLICATION_INSTALL_SOURCE_SYNC Die Installationsquelle der Anwendung ist eine Synchronisierung.
APPLICATION_INSTALL_SOURCE_PLAY_STORE Die App wurde aus dem Play Store installiert.
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 Die Anwendung ist mit dem System installiert und gilt als Teil des Betriebssystems.
APPLICATION_INSTALL_REASON_POLICY Die App wurde durch eine Richtlinie installiert.
APPLICATION_INSTALL_REASON_OEM Anwendung, die von einem Erstausrüster (Original Equipment Manufacturer, OEM) installiert wurde.
APPLICATION_INSTALL_REASON_DEFAULT Die App ist standardmäßig installiert, gilt aber nicht als System-App.
APPLICATION_INSTALL_REASON_SYNC Die Anwendung wurde durch die Synchronisierung installiert.
APPLICATION_INSTALL_REASON_USER Die Anwendung wurde durch eine Nutzeraktion installiert.
APPLICATION_INSTALL_REASON_SUB_APP Anwendung, die durch einen SubApp API-Aufruf installiert wurde.
APPLICATION_INSTALL_REASON_KIOSK Anwendung, die von Kiosk unter ChromeOS installiert wurde.
APPLICATION_INSTALL_REASON_COMMAND_LINE Anwendung, die über ein Befehlszeilenargument installiert wurde.

ApplicationInstallTime

Beschreibt die Installationszeit der App in Abhängigkeit vom App-Lebenszyklus.

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

TelemetryAppUninstallEvent

Daten zur Deinstallation von Apps.

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 das 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 Die Quelle der App-Deinstallation ist unbekannt.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Die Anwendung 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 Die Anwendung wurde aus der Ablage deinstalliert.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Die Anwendung wurde durch die App-Migration deinstalliert.

TelemetryAppLaunchEvent

App-Startdaten.

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

enum (ApplicationLaunchSource)

Quelle des App-Starts.
appId

string

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

enum (TelemetryApplicationType)

App-Typ.

ApplicationLaunchSource

Beschreibt die Quelle des App-Starts.

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

TelemetryOsCrashEvent

Daten zu Betriebssystemabstürzen.

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

enum (CrashType)

Absturztyp
sessionType

enum (SessionType)

Sitzungstyp.
crashId

string

Absturz-ID.

CrashType

Beschreibt den Absturztyp.

Enums
CRASH_TYPE_UNSPECIFIED Unbekannter Absturztyp.
CRASH_TYPE_KERNEL Kernel-Absturz.
CRASH_TYPE_EMBEDDED_CONTROLLER Absturz des eingebetteten Controllers.

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

TelemetryExternalDisplayEvent

Nutzlast für Ereignisse, wenn ein externes Display verbunden oder getrennt wird.

JSON-Darstellung 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Felder
externalDisplayData[]

object (TelemetryExternalDisplayData)

Liste der externen Displays, die verbunden/getrennt wurden.

TelemetryExternalDisplayData

Daten für externe Displays.

JSON-Darstellung 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Felder
displayName

string

Der Anzeigename.
resolutionHorizontal

integer

Die horizontale Auflösung.
resolutionVertical

integer

Die vertikale Auflösung.
refreshRate

string (int64 format)

Die Aktualisierungsrate.
serialNumber

integer

Die Seriennummer.
edidVersion

string

Die EDID-Version.

Methoden

list

 Telemetrieereignisse auflisten