REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Von einem verwalteten Gerät gemeldete Telemetriedaten.

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 Gerät, das dem Ereignis zugeordnet ist.
user

object (TelemetryUserInfo)

Nur Ausgabe. Informationen zu dem Nutzer, der dem Ereignis zugeordnet ist.
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 schwerwiegendes Audio-Unterlaufereignis. Nur vorhanden, wenn das Feld eventType den Wert AUDIO_SEVERE_UNDERRUN hat.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe. Nutzlast für ein Änderungsereignis des Status der Netzwerkverbindung. Nur vorhanden, wenn eventType gleich NETWORK_STATE_CHANGE ist.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Nur Ausgabe. Nutzlast für HTTPS-Latenzänderungsereignis. Nur vorhanden, wenn eventType gleich NETWORK_HTTPS_LATENCY_CHANGE ist.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe. Nutzlast für ein Änderungsereignis des VPN-Verbindungsstatus. Nur vorhanden, wenn eventType gleich VPN_CONNECTION_STATE_CHANGE ist.
appInstallEvent

object (TelemetryAppInstallEvent)

Nur Ausgabe. Nutzlast für App-Installationsereignis. Nur vorhanden, wenn eventType gleich APP_INSTALLED ist.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Nur Ausgabe. Nutzlast für das Deinstallationsereignis der App. Nur vorhanden, wenn eventType gleich APP_UNINSTALLED ist.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Nur Ausgabe. Nutzlast für App-Startereignis.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 ID der Directory API der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.
orgUnitId

string

Nur Ausgabe. ID der Organisationseinheit des Geräts.

TelemetryUserInfo

Informationen zu einem Nutzer, der mit Telemetriedaten verknüpft ist.

  • 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 die Zwischenspeicherdaten für ein Audiogerät länger als 5 Sekunden aufgebraucht sind.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

„TelemetryUsbPeripheralsEvent“ löst aus, dass USB-Geräte entweder hinzugefügt oder entfernt werden.

  • 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 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 das Gerät von einem Latenzproblem wiederhergestellt wurde.

  • 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 hat sich aufgrund eines Problems behoben.
PROBLEM HTTPS-Latenzproblem.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent wird bei Ereignissen zur 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)

Quelle der App-Installation.
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 dies die Start-URL und bei Erweiterungen die Erweiterungs-ID.
appType

enum (TelemetryApplicationType)

Typ der App.

ApplicationInstallSource

Beschreibt die Installationsquelle der App.

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Die Installationsquelle der Anwendung ist unbekannt.
APPLICATION_INSTALL_SOURCE_SYSTEM Die App wurde als Teil von Chrome OS installiert.
APPLICATION_INSTALL_SOURCE_SYNC Die Installationsquelle der Anwendung ist eine Synchronisierung.
APPLICATION_INSTALL_SOURCE_PLAY_STORE Die App-Installationsquelle 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 Anwendung, die mit dem System installiert wird und als Teil des Betriebssystems betrachtet wird.
APPLICATION_INSTALL_REASON_POLICY Durch Richtlinie installierte Anwendung.
APPLICATION_INSTALL_REASON_OEM Von einem Erstausrüster (OEM) installierte Anwendung.
APPLICATION_INSTALL_REASON_DEFAULT Die App ist standardmäßig installiert, wird aber nicht als System-App betrachtet.
APPLICATION_INSTALL_REASON_SYNC Anwendung durch Synchronisierung installiert.
APPLICATION_INSTALL_REASON_USER Durch Nutzeraktion installierte Anwendung.
APPLICATION_INSTALL_REASON_SUB_APP SubApp API-Aufruf der installierten Anwendung.
APPLICATION_INSTALL_REASON_KIOSK Von Kiosk unter Chrome OS installierte Anwendung.
APPLICATION_INSTALL_REASON_COMMAND_LINE Durch Befehlszeilenargument installierte Anwendung.

ApplicationInstallTime

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

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

TelemetryAppUninstallEvent

Daten zu App-Deinstallationen.

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 dies die Start-URL und bei Erweiterungen die Erweiterungs-ID.
appType

enum (TelemetryApplicationType)

Typ der App.

ApplicationUninstallSource

Beschreibt die Deinstallationsquelle der App.

Enums
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Deinstallation der Anwendung ist unbekannt.
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 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)

Startquelle der App.
appId

string

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

enum (TelemetryApplicationType)

Typ der App.

ApplicationLaunchSource

Beschreibt die Startquelle der App.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Startquelle der Anwendung unbekannt.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Die Anwendung wird über das Raster der Apps gestartet, nicht über das Suchfeld.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU App wird aus dem App-Raster über das Kontextmenü gestartet.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Anwendung wurde aus abfrageabhängigen Ergebnissen gestartet (größere Symbole).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Anwendung, die über abfrageabhängige Ergebnisse aus dem Kontextmenü gestartet wird.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Anwendung über Empfehlungen ohne Abfragen gestartet (kleinere Symbole).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Die App wurde über den Bereich mit den Jugendschutzeinstellungen und über die Benachrichtigung nach App-Zeit gestartet.
APPLICATION_LAUNCH_SOURCE_SHELF Anwendung aus Ablage gestartet.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Anwendung über Dateimanager gestartet
APPLICATION_LAUNCH_SOURCE_OMNIBOX Anwendung wurde durch Eingabe einer URL in die Omnibox im Browser gestartet.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Die Anwendung wurde aus einem internen Chrome-Aufruf gestartet.
APPLICATION_LAUNCH_SOURCE_KEYBOARD App wurde über die Tastenkombination 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 Anwendung gestartet über Menü.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Anwendung wurde über die installierte Benachrichtigung gestartet.
APPLICATION_LAUNCH_SOURCE_TEST Die Anwendung wurde aus einem Test gestartet.
APPLICATION_LAUNCH_SOURCE_ARC Die Anwendung wurde über Arc gestartet.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Anwendung 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 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 zum Tab „Entdecken“ gestartet.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Anwendung wurde über die Management API gestartet.
APPLICATION_LAUNCH_SOURCE_KIOSK Anwendung vom Kiosk gestartet.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Anwendung wurde über die Befehlszeile gestartet.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Die App wurde im Hintergrundmodus gestartet.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Anwendung wurde über die „Neuer Tab“-Seite gestartet.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Die Anwendung wurde über eine Intent-URL gestartet.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Die App wurde über OS Login gestartet.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Die Anwendung wurde über den Protokoll-Handler gestartet.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Anwendung wurde über URL-Handler gestartet.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Die App wurde über den App Launcher auf dem Sperrbildschirm gestartet.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Die App wurde über den Startbildschirm der App (chrome://apps) gestartet.
APPLICATION_LAUNCH_SOURCE_REPARENTING App wurde nach dem Verschieben von Inhalten in eine App gestartet.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Anwendung wird über das Profilmenü der installierbaren Web-UI chrome://password-manager gestartet.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Anwendung wurde über den Kalender in der Taskleiste gestartet.
APPLICATION_LAUNCH_SOURCE_INSTALLER Anwendung wurde über das Quell-Installationsprogramm gestartet.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Zählung der erstmaligen 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 Willkommenstour gestartet.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE App wurde aus dem Fokusbereich gestartet.
APPLICATION_LAUNCH_SOURCE_SPARKY Die Anwendung wurde über die experimentelle Funktion Sparky gestartet.

Methoden

list

 Telemetrieereignisse auflisten.