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)
  }
}
Felder
name

string

Nur Ausgabe. Ressourcenname des Ereignisses.
device

object (TelemetryDeviceInfo)

Nur Ausgabe. Informationen zu dem mit dem Ereignis verknüpften Gerät.
user

object (TelemetryUserInfo)

Nur Ausgabe. Informationen über den mit dem Ereignis verknüpften Nutzer.
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann das Ereignis gemeldet wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

Der Ereignistyp des aktuellen Ereignisses.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Nur Ausgabe. Nutzlast für ein schweres Unterlaufen der Audiospur. Ist 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 „Statusänderung der Netzwerkverbindung“. Nur präsentieren, wenn eventType den Wert NETWORK_STATE_CHANGE hat.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Nur Ausgabe. Nutzlast für das HTTPS-Latenzereignisänderungsereignis. Nur präsentieren, wenn eventType den Wert NETWORK_HTTPS_LATENCY_CHANGE hat.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Nur Ausgabe. Nutzlast für WLAN-Signalstärke-Ereignisse. Nur vorhanden, wenn eventType den Wert WIFI_SIGNAL_STRENGTH_LOW oder WIFI_SIGNAL_STRENGTH_RECOVERED hat.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe. Nutzlast für das Ereignis „Änderung des VPN-Verbindungsstatus“. Nur präsentieren, wenn eventType den Wert VPN_CONNECTION_STATE_CHANGE hat.
appInstallEvent

object (TelemetryAppInstallEvent)

Nur Ausgabe. Nutzlast für App-Installationsereignis. Nur präsentieren, wenn eventType den Wert APP_INSTALLED hat.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Nur Ausgabe. Nutzlast für das Ereignis „App-Deinstallation“. Nur präsentieren, wenn eventType den Wert APP_UNINSTALLED hat.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Nur Ausgabe. Nutzlast für App-Start-Ereignis.Nur vorhanden, wenn eventType den Wert APP_LAUNCHED hat.

TelemetryDeviceInfo

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

  • Detaillierte Berechtigung erforderlich: 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. ID der Organisationseinheit des Geräts.

TelemetryUserInfo

Informationen zu einem Nutzer, die Telemetriedaten zugeordnet 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. ID der Organisationseinheit des Nutzers.

TelemetryAudioSevereUnderrunEvent

Dieser Typ hat keine Felder.

TelemetryAudioSevereUnderrunEvent wird ausgelöst, wenn einem Audiogerät für mehr als 5 Sekunden keine Zwischenspeicherdaten mehr zur Verfügung stehen.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent ausgelöste USB-Geräte werden 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 entweder hinzugefügt oder entfernt wurden.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent wird bei Änderungen des Status der Netzwerkverbindung ausgelöst.

  • Detaillierte Berechtigung erforderlich: 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 ein Latenzproblem behoben hat.

  • Detaillierte Berechtigung erforderlich: 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 HTTPS-Latenzstatus ist nicht angegeben.
RECOVERY Die HTTPS-Latenz wurde aus einem Problem wiederhergestellt.
PROBLEM HTTPS-Latenzproblem.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent wird durch WLAN-Signalstärke ausgelöst.

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

string

Eindeutige Kennung des Netzwerks.
signalStrengthDbm

integer

RSSI-Wert für die Signalstärke.

TelemetryAppInstallEvent

App-Installationsdaten.

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

enum (ApplicationInstallSource)

App-Installationsquelle.
appInstallReason

enum (ApplicationInstallReason)

Grund für die App-Installation.
appInstallTime

enum (ApplicationInstallTime)

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

string

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

enum (TelemetryApplicationType)

Art der App.

ApplicationInstallSource

Beschreibt die Installationsquelle der App.

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Die Installationsquelle der Anwendung ist unbekannt.
APPLICATION_INSTALL_SOURCE_SYSTEM Anwendung, die als Teil von Chrome OS installiert wurde.
APPLICATION_INSTALL_SOURCE_SYNC Die Installationsquelle 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 App-Installation.

Enums
APPLICATION_INSTALL_REASON_UNSPECIFIED Der Grund für die Installation der Anwendung ist unbekannt.
APPLICATION_INSTALL_REASON_SYSTEM Die Anwendung wurde mit dem System installiert und gilt als Teil des Betriebssystems.
APPLICATION_INSTALL_REASON_POLICY Die Anwendung wurde über eine Richtlinie installiert.
APPLICATION_INSTALL_REASON_OEM Die Anwendung wurde von einem Erstausrüster (OEM) installiert.
APPLICATION_INSTALL_REASON_DEFAULT Die App wird standardmäßig installiert, gilt aber nicht als System-App.
APPLICATION_INSTALL_REASON_SYNC Anwendung durch Synchronisierung installiert.
APPLICATION_INSTALL_REASON_USER App wurde durch Nutzeraktion installiert.
APPLICATION_INSTALL_REASON_SUB_APP App hat bt SubApp API-Aufruf installiert.
APPLICATION_INSTALL_REASON_KIOSK Die Anwendung wurde von Kiosk unter ChromeOS installiert.
APPLICATION_INSTALL_REASON_COMMAND_LINE Durch Befehlszeilenargument installierte Anwendung.

ApplicationInstallTime

Beschreibt die Installationszeit der App abhängig vom App-Lebenszyklus.

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

TelemetryAppUninstallEvent

Daten zu Deinstallationen der App.

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

enum (ApplicationUninstallSource)

Quelle für die Deinstallation der App.
appId

string

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

enum (TelemetryApplicationType)

Art der App.

ApplicationUninstallSource

Beschreibt die Deinstallationsquelle der App.

Enums
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Unbekannte Quelle für Deinstallation der Anwendung.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Die App wurde aus der App-Liste (Launcher) deinstalliert.
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Die Anwendung wurde über die Seite „App-Verwaltung“ deinstalliert.
APPLICATION_UNINSTALL_SOURCE_SHELF Die Anwendung wurde aus der Ablage deinstalliert.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Die Anwendung wurde durch 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 App-Start.
appId

string

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

enum (TelemetryApplicationType)

Art der App.

ApplicationLaunchSource

Beschreibt die Quelle der App-Einführung.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Startquelle der App 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 Die App wird über das App-Raster und außerhalb des Kontextmenüs 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 Anwendung wird über abfrageabhängige Ergebnisse außerhalb des Kontextmenüs gestartet.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION App wird über Empfehlungen ohne Abfragen gestartet (kleinere Symbole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Die App wurde über den Bereich „Jugendschutzeinstellungen“ und die App-Benachrichtigung gestartet.
APPLICATION_LAUNCH_SOURCE_SHELF App wurde über die Ablage gestartet.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Anwendung über den Dateimanager gestartet
APPLICATION_LAUNCH_SOURCE_OMNIBOX Die Anwendung wurde durch Eingabe einer URL in die Omnibox im Browser gestartet.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL App wurde über einen internen Chrome-Aufruf gestartet.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Die App wird über das Tastaturkürzel zum Öffnen der App gestartet.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Die Anwendung wurde durch Klicken auf einen Link in einer anderen App oder WebUI gestartet.
APPLICATION_LAUNCH_SOURCE_MENU App wurde über das Menü gestartet.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Die App wurde über die installierte Benachrichtigung gestartet.
APPLICATION_LAUNCH_SOURCE_TEST App wurde über einen Test gestartet.
APPLICATION_LAUNCH_SOURCE_ARC Anwendung über Arc gestartet.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Die App wurde über Sharesheet gestartet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Die Anwendung wurde über die Benachrichtigung zu den Versionshinweisen gestartet.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Anwendung nach vollständiger Wiederherstellung gestartet.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU App wird über ein Kontextmenü zur intelligenten Textauswahl gestartet.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION App wurde über eine Benachrichtigung auf dem Tab „Entdecken“ gestartet.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Anwendung, die über die Management API gestartet wurde.
APPLICATION_LAUNCH_SOURCE_KIOSK App wurde über den Kiosk gestartet.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Die Anwendung wurde über die Befehlszeile gestartet.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE App wurde im Hintergrundmodus gestartet.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Die Anwendung wurde über die Seite „Neuer Tab“ gestartet.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Die Anwendung wurde über eine Intent-URL gestartet.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Die Anwendung wurde über OS Login gestartet.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Anwendung über Protokoll-Handler gestartet.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Anwendung über URL-Handler gestartet.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN App wird über den App Launcher auf dem Sperrbildschirm gestartet.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Die Anwendung wird über die Startseite der App (chrome://apps) gestartet.
APPLICATION_LAUNCH_SOURCE_REPARENTING App wurde durch das Verschieben von Inhalten in eine App gestartet.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Die Anwendung wurde über das Profilmenü der installierbaren Web-UI chrome://password-manager 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 erstmaligen Starts von Hilfe-Apps separat, damit wir die Anzahl der vom Nutzer ausgelösten Starts nachvollziehen können.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Die App wurde nach der Willkommenstour gestartet.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Die Anwendung wurde über den Fokusbereich gestartet.

Methoden

list

 Telemetrieereignisse auflisten.