REST Resource: customers.telemetry.events

Zasób: TelemetryEvent

Dane telemetryczne zgłaszane przez urządzenie zarządzane.

Zapis 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)
  }
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu zdarzenia.
device

object (TelemetryDeviceInfo)

Tylko dane wyjściowe. Informacje o urządzeniu powiązanym ze zdarzeniem.
user

object (TelemetryUserInfo)

Tylko dane wyjściowe. Informacje o użytkowniku powiązanym ze zdarzeniem.
reportTime

string (Timestamp format)

Sygnatura czasowa określająca, kiedy zdarzenie zostało zgłoszone.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

Typ bieżącego zdarzenia.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Tylko dane wyjściowe. Ładunek w przypadku zdarzenia poważnego niedostatecznego uruchomienia dźwięku. Widoczny tylko wtedy, gdy pole eventType ma wartość AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Tylko dane wyjściowe. Zdarzenie urządzeń peryferyjnych USB. Widoczny tylko wtedy, gdy pole eventType zawiera wartość USB_ADDED lub USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Tylko dane wyjściowe. Ładunek dla zdarzenia zmiany stanu połączenia sieciowego. Prezentuj tylko wtedy, gdy eventType ma wartość NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Tylko dane wyjściowe. Ładunek dla zdarzenia zmiany opóźnienia HTTPS. Prezentuj tylko wtedy, gdy eventType ma wartość NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Tylko dane wyjściowe. Ładunek zdarzeń siły sygnału Wi-Fi. Prezentuj tylko wtedy, gdy eventType ma wartość WIFI_SIGNAL_STRENGTH_LOW lub WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Tylko dane wyjściowe. Zdarzenie zmiany stanu połączenia VPN ładunku. Prezentuj tylko wtedy, gdy eventType ma wartość VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Tylko dane wyjściowe. Ładunek danych zdarzenia instalacji aplikacji. Prezentuj tylko wtedy, gdy eventType ma wartość APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Tylko dane wyjściowe. Ładunek zdarzenia odinstalowania aplikacji. Prezentuj tylko wtedy, gdy eventType ma wartość APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Tylko dane wyjściowe. Ładunek danych zdarzenia uruchomienia aplikacji.Prezentuj tylko wtedy, gdy eventType ma wartość APP_LAUNCHED.

TelemetryDeviceInfo

Informacje o urządzeniu powiązanym z danymi telemetrycznymi.

  • Wymagane szczegółowe uprawnienia: TELEMETRY_API_DEVICE
Zapis JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
Pola
deviceId

string

Tylko dane wyjściowe. Unikalny identyfikator interfejsu Directory API urządzenia. Ta wartość jest taka sama jak identyfikator interfejsu Directory API w konsoli administracyjnej na karcie Urządzenia z ChromeOS.
orgUnitId

string

Tylko dane wyjściowe. Identyfikator jednostki organizacyjnej urządzenia.

TelemetryUserInfo

Informacje o użytkowniku powiązane z danymi telemetrycznymi.

  • Potrzebne są szczegółowe uprawnienia: TELEMETRY_API_USER
Zapis JSON 
{
  "email": string,
  "orgUnitId": string
}
Pola
email

string

Tylko dane wyjściowe. Adres e-mail użytkownika.
orgUnitId

string

Tylko dane wyjściowe. Identyfikator jednostki organizacyjnej użytkownika.

TelemetryAudioSevereUnderrunEvent

Ten typ nie zawiera pól.

Funkcja TelemetryAudioSevereUnderrunEvent jest wyzwalana, gdy urządzeniu audio nie ma danych z bufora na ponad 5 sekund.

  • Potrzebne są szczegółowe uprawnienia: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Urządzenia USB zostały aktywowane przez TelemetryUsbPeripheralsEvent.

  • Potrzebne są szczegółowe uprawnienia: TELEMETRY_API_PERIPHERALS_REPORT
Zapis JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Pola
usbPeripheralReport[]

object (UsbPeripheralReport)

Lista dodanych lub usuniętych urządzeń USB.

TelemetryNetworkConnectionStateChangeEvent

Funkcja TelemetryNetworkConnectionStateChangeEvent jest wyzwalana po zmianie stanu połączenia sieciowego.

  • Potrzebne są szczegółowe uprawnienia: TELEMETRY_API_NETWORK_REPORT
Zapis JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Pola
guid

string

Unikalny identyfikator sieci.
connectionState

enum (NetworkConnectionState)

Bieżący stan połączenia sieci.

TelemetryHttpsLatencyChangeEvent

Rutyna opóźnienia HTTP jest uruchamiana okresowo i wyzwalana w przypadku wykrycia problemu z opóźnieniem lub przywrócenia funkcji urządzenia po powrocie do normalnego działania.TelemetryHttpsLatencyChangeEvent

  • Potrzebne są szczegółowe uprawnienia: TELEMETRY_API_NETWORK_REPORT
Zapis JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Pola
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Dane rutynowego opóźnienia HTTPS, które wywołało zdarzenie.
httpsLatencyState

enum (HttpsLatencyState)

Bieżący stan opóźnienia HTTPS.

HttpsLatencyState

Stan opóźnienia HTTPS.

Wartości w polu enum
HTTPS_LATENCY_STATE_UNSPECIFIED Stan opóźnienia HTTPS jest nieokreślony.
RECOVERY W wyniku problemu udało się zredukować czas oczekiwania na HTTPS.
PROBLEM Problem z opóźnieniem HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent jest wyzwalany w przypadku zdarzeń siły sygnału Wi-Fi.

  • Potrzebne są szczegółowe uprawnienia: TELEMETRY_API_NETWORK_REPORT
Zapis JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Pola
guid

string

Unikalny identyfikator sieci.
signalStrengthDbm

integer

Wartość RSSI siły sygnału.

TelemetryAppInstallEvent

Dane instalacji aplikacji.

Zapis JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Pola
appInstallSource

enum (ApplicationInstallSource)

Źródło instalacji aplikacji.
appInstallReason

enum (ApplicationInstallReason)

Powód instalacji aplikacji.
appInstallTime

enum (ApplicationInstallTime)

Czas instalacji aplikacji w zależności od cyklu życia aplikacji.
appId

string

Identyfikator aplikacji W przypadku aplikacji PWA jest to początkowy URL, a w przypadku rozszerzeń jest to identyfikator rozszerzenia.
appType

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationInstallSource

Opisuje źródło instalacji aplikacji.

Wartości w polu enum
APPLICATION_INSTALL_SOURCE_UNSPECIFIED Źródło instalacji aplikacji jest nieznane.
APPLICATION_INSTALL_SOURCE_SYSTEM Aplikacja zainstalowana jako część Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC Źródło instalacji aplikacji to synchronizacja.
APPLICATION_INSTALL_SOURCE_PLAY_STORE Źródłem instalacji aplikacji jest Sklep Play.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE Źródłem instalacji aplikacji jest Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER Źródłem instalacji aplikacji jest przeglądarka.

ApplicationInstallReason

Podaje powód instalacji aplikacji.

Wartości w polu enum
APPLICATION_INSTALL_REASON_UNSPECIFIED Przyczyna instalacji aplikacji jest nieznana.
APPLICATION_INSTALL_REASON_SYSTEM Aplikacja zainstalowana w systemie i uważana za część systemu operacyjnego.
APPLICATION_INSTALL_REASON_POLICY Aplikacja zainstalowana przez zasady.
APPLICATION_INSTALL_REASON_OEM Aplikacja zainstalowana przez producenta oryginalnego sprzętu (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Aplikacja jest instalowana domyślnie, ale nie jest uznawana za aplikację systemową.
APPLICATION_INSTALL_REASON_SYNC Aplikacja zainstalowana przez synchronizację.
APPLICATION_INSTALL_REASON_USER Aplikacja została zainstalowana w wyniku działania użytkownika.
APPLICATION_INSTALL_REASON_SUB_APP Wywołanie interfejsu bt SubApp API zainstalowanej aplikacji.
APPLICATION_INSTALL_REASON_KIOSK Aplikacja zainstalowana przez kiosk w systemie operacyjnym Chrome.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplikacja zainstalowana przez argument wiersza poleceń.

ApplicationInstallTime

Opisuje czas instalacji aplikacji w zależności od cyklu życia aplikacji.

Wartości w polu enum
APPLICATION_INSTALL_TIME_UNSPECIFIED Nieznany czas instalacji aplikacji.
APPLICATION_INSTALL_TIME_INIT Rozpoczęto instalację aplikacji.
APPLICATION_INSTALL_TIME_RUNNING Trwa instalacja aplikacji.

TelemetryAppUninstallEvent

Dane odinstalowanych aplikacji.

Zapis JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Pola
appUninstallSource

enum (ApplicationUninstallSource)

Źródło odinstalowania aplikacji.
appId

string

Identyfikator aplikacji W przypadku aplikacji PWA jest to początkowy URL, a w przypadku rozszerzeń jest to identyfikator rozszerzenia.
appType

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationUninstallSource

Opisuje źródło odinstalowania aplikacji.

Wartości w polu enum
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Nieznane źródło odinstalowania aplikacji.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Aplikacja została odinstalowana z listy aplikacji (program uruchamiający).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Aplikacja została odinstalowana ze strony Zarządzanie aplikacjami.
APPLICATION_UNINSTALL_SOURCE_SHELF Aplikacja została odinstalowana z półki.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Aplikacja została odinstalowana przez migrację aplikacji.

TelemetryAppLaunchEvent

Dane dotyczące uruchamiania aplikacji.

Zapis JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Pola
appLaunchSource

enum (ApplicationLaunchSource)

Źródło uruchamiania aplikacji.
appId

string

Identyfikator aplikacji W przypadku aplikacji PWA jest to początkowy URL, a w przypadku rozszerzeń jest to identyfikator rozszerzenia.
appType

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationLaunchSource

Opisuje źródło uruchamiania aplikacji.

Wartości w polu enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Źródło uruchamiania aplikacji nieznane.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Aplikacja uruchamiana z siatki aplikacji, a nie z pola wyszukiwania.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplikacja uruchamiana z siatki aplikacji poza menu kontekstowego.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Aplikacja uruchamiana z wyników zależnych od zapytania (większe ikony).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Aplikacja uruchamiana z wyników wyszukiwania zależnych od zapytania, bez dostępu do menu kontekstowego.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplikacja została uruchomiona z wykorzystaniem rekomendacji bez zapytań (mniejsze ikony).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Aplikacja uruchamiana z sekcji Ustawienia kontroli rodzicielskiej oraz powiadomień według aplikacji.
APPLICATION_LAUNCH_SOURCE_SHELF Aplikacja została uruchomiona z półki.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplikacja została uruchomiona z poziomu menedżera plików
APPLICATION_LAUNCH_SOURCE_OMNIBOX Aplikacja została uruchomiona przez wpisanie adresu URL w omniboksie w przeglądarce.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplikacja została uruchomiona przy użyciu wewnętrznego wywołania Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplikacja uruchamiana za pomocą skrótu klawiszowego służącego do otwierania aplikacji.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplikacja uruchamiana przez kliknięcie linku w innej aplikacji lub interfejsie WebUI.
APPLICATION_LAUNCH_SOURCE_MENU Aplikacja została uruchomiona z menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplikacja została uruchomiona z poziomu powiadomienia o zainstalowaniu.
APPLICATION_LAUNCH_SOURCE_TEST Aplikacja uruchomiona z testu.
APPLICATION_LAUNCH_SOURCE_ARC Aplikacja uruchomiona w Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplikacja została uruchomiona z arkusza udostępniania.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplikacja została uruchomiona z poziomu powiadomienia z informacjami o wersji.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplikacja została uruchomiona od przywrócenia pełnej funkcjonalności.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplikacja została uruchomiona z poziomu menu kontekstowego inteligentnego zaznaczania tekstu.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Aplikacja uruchamiana z powiadomienia na karcie odkrywania.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplikacja uruchomiona przez interfejs API zarządzania.
APPLICATION_LAUNCH_SOURCE_KIOSK Aplikacja uruchamiana z kiosku.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplikacja uruchamiana z wiersza poleceń.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Aplikacja została uruchomiona w trybie działania w tle.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Aplikacja została uruchomiona ze strony nowej karty.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Aplikacja została uruchomiona z adresu URL intencji.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Aplikacja uruchomiona z OS Login.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplikacja została uruchomiona z modułu obsługi protokołów.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplikacja została uruchomiona z modułu obsługi adresu URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplikacja uruchamiana z poziomu Menu z aplikacjami na ekranie blokady.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplikacja uruchamiana na stronie głównej aplikacji (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplikacja uruchamiana po przeniesieniu treści do aplikacji.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Aplikacja została uruchomiona z menu profilu w interfejsie WebUI chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplikacja została uruchomiona z poziomu kalendarza w obszarze powiadomień.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplikacja została uruchomiona z instalatora źródłowego.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Możesz zliczać uruchomienia aplikacji pomocy przy pierwszym uruchomieniu, abyśmy mogli poznać liczbę uruchomień wywołanych przez użytkowników.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Aplikacja została uruchomiona z poziomu prezentacji powitalnej.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Aplikacja została uruchomiona z panelu fokusu.
APPLICATION_LAUNCH_SOURCE_SPARKY Aplikacja uruchomiona z eksperymentalnej funkcji Sparky.

Metody

list

 Wyświetlanie listy zdarzeń telemetrycznych.