REST Resource: customers.telemetry.events

Zasób: TelemetryEvent

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

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, która określa, kiedy zdarzenie zostało zgłoszone.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 poważnego niezatrzymania dźwięku. Widoczne tylko wtedy, gdy pole eventType ma wartość AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Tylko dane wyjściowe. Ładunek dla zdarzenia peryferyjnego USB. Widoczne tylko wtedy, gdy pole eventType ma wartość USB_ADDED lub USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

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

object (TelemetryHttpsLatencyChangeEvent)

Tylko dane wyjściowe. Ładunek zdarzenia zmiany czasu oczekiwania HTTPS. Widoczny 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. Widoczny tylko wtedy, gdy eventType ma wartość WIFI_SIGNAL_STRENGTH_LOW lub WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Tylko dane wyjściowe. Ładunek zdarzenia zmiany stanu połączenia VPN. Widoczny tylko wtedy, gdy eventType ma wartość VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

Tylko dane wyjściowe. Ładunek na potrzeby zdarzenia uruchomienia aplikacji.Widoczny 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 z 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ązanym z danymi telemetrycznymi.

  • Wymagane 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 ma żadnych pól.

Funkcja TelemetryAudioSevereUnderrunEvent jest wywoływana, gdy na urządzeniu audio zabraknie danych bufora przez ponad 5 sekund.

  • Wymagane szczegółowe uprawnienia: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

Wywołanie aplikacji TelemetryUsbPeripheralsEvent: urządzenia USB zostały dodane lub usunięte.

  • Wymagane 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

TelemetryNetworkConnectionStateChangeEvent jest aktywowany w przypadku zmiany stanu połączenia sieciowego.

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

string

Niepowtarzalny identyfikator sieci.
connectionState

enum (NetworkConnectionState)

Bieżący stan połączenia z siecią.

TelemetryHttpsLatencyChangeEvent

Rutyna opóźnienia HTTPS jest uruchamiana okresowo, a TelemetryHttpsLatencyChangeEvent jest wyzwalana po wykryciu problemu z opóźnieniem lub po wznowieniu działania urządzenia w przypadku wystąpienia problemu z opóźnieniem.

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

object (HttpsLatencyRoutineData)

Dane rutyny opóźnienia HTTPS, które wywołały 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 Czas oczekiwania HTTPS został rozwiązany w ramach problemu.
PROBLEM Problem z opóźnieniem HTTPS.

TelemetryNetworkSignalStrengthEvent

Funkcja TelemetryNetworkSignalStrengthEvent jest wywoływana w przypadku zdarzeń siły sygnału Wi-Fi.

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

string

Niepowtarzalny identyfikator sieci.
signalStrengthDbm

integer

Wartość sygnału RSSI.

TelemetryAppInstallEvent

Dane o 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)

Przyczyna instalacji aplikacji.
appInstallTime

enum (ApplicationInstallTime)

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

string

Identyfikator aplikacji. W przypadku PWA jest to początkowy adres URL, a w przypadku rozszerzeń – 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 w ramach systemu operacyjnego Chrome.
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ło instalacji aplikacji to Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER Źródłem instalacji aplikacji jest przeglądarka.

ApplicationInstallReason

Opisuje 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 jest 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 zainstalowana domyślnie, ale nie jest uznawana za aplikację systemową.
APPLICATION_INSTALL_REASON_SYNC Aplikacja zainstalowana przez synchronizację.
APPLICATION_INSTALL_REASON_USER Aplikacja zainstalowana przez użytkownika.
APPLICATION_INSTALL_REASON_SUB_APP Wywołanie interfejsu SubApp API bt aplikacji zainstalowanej aplikacji.
APPLICATION_INSTALL_REASON_KIOSK Aplikacja zainstalowana przez kiosk w systemie operacyjnym Chrome.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplikacja zainstalowana przy użyciu argumentu wiersza poleceń.

ApplicationInstallTime

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

Wartości w polu enum
APPLICATION_INSTALL_TIME_UNSPECIFIED Nieznany czas instalacji aplikacji.
APPLICATION_INSTALL_TIME_INIT Instalacja aplikacji została zainicjowana.
APPLICATION_INSTALL_TIME_RUNNING Trwa instalowanie aplikacji.

TelemetryAppUninstallEvent

Dane odinstalowań aplikacji.

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

enum (ApplicationUninstallSource)

Źródło odinstalowań aplikacji.
appId

string

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

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationUninstallSource

Opisuje źródło odinstalowania aplikacji.

Wartości w polu enum
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Źródło odinstalowania aplikacji jest nieznane.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Aplikacja została odinstalowana z listy aplikacji (w Menu z aplikacjami).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Aplikacja została odinstalowana ze strony zarządzania 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 PWA jest to początkowy adres URL, a w przypadku rozszerzeń – identyfikator rozszerzenia.
appType

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationLaunchSource

Opisuje źródło wprowadzenia aplikacji na rynek.

Wartości w polu enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Źródło uruchomienia aplikacji jest nieznane.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Aplikacja uruchamia się z siatki aplikacji, a nie z pola wyszukiwania.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplikacja uruchamiana z siatki aplikacji poza menu kontekstowe.
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 zależnych od zapytania poza menu kontekstowym.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplikacja uruchamiana z rekomendacji bez zapytań (mniejsze ikony).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Aplikacja uruchamiana z sekcji Ustawienia kontroli rodzicielskiej i powiadomienia o korzystaniu z aplikacji.
APPLICATION_LAUNCH_SOURCE_SHELF Aplikacja uruchamiana z półki.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplikacja uruchamiana z menedżera plików
APPLICATION_LAUNCH_SOURCE_OMNIBOX Aplikacja uruchamiana przez wpisanie adresu URL w omniboksie w przeglądarce.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplikacja została uruchomiona w wyniku rozmowy wewnętrznej w Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplikacja uruchamiana za pomocą skrótu klawiszowego otwierającego aplikację.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplikacja uruchamiana przez kliknięcie linku w innej aplikacji lub interfejsie WebUI.
APPLICATION_LAUNCH_SOURCE_MENU Aplikacja uruchomiona z menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplikacja uruchamiana z powiadomienia o zainstalowaniu.
APPLICATION_LAUNCH_SOURCE_TEST Aplikacja uruchomiona z testu.
APPLICATION_LAUNCH_SOURCE_ARC Aplikacja uruchomiona z Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplikacja uruchomiona z Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplikacja została uruchomiona z poziomu powiadomienia z informacjami o wersji.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplikacja uruchomiona z pełnego przywracania.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplikacja została uruchomiona z menu kontekstowego inteligentnego wyboru tekstu.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Aplikacja została uruchomiona z powiadomienia na karcie odkrywania.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplikacja uruchomiona z poziomu interfejsu API zarządzania.
APPLICATION_LAUNCH_SOURCE_KIOSK Aplikacja uruchomiona z kiosku.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplikacja uruchamiana z wiersza poleceń.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Aplikacja uruchamiana 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 uruchomiona z adresu URL intencji.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Aplikacja uruchamiana przez OS Login.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplikacja uruchomiona z modułu obsługi protokołu.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplikacja uruchomiona z modułu obsługi adresów URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplikacja została uruchomiona z menu z aplikacjami na ekranie blokady.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplikacja została uruchomiona ze strony głównej aplikacji (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplikacja uruchamiana przez przenoszenie treści do aplikacji.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Aplikacja została uruchomiona z menu profilu w instalacyjnym interfejsie WebUI chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplikacja została uruchomiona z kalendarza w obszarze powiadomień.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplikacja została uruchomiona z instalatora źródłowego.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Zliczaj oddzielnie uruchomienia aplikacji pomocy przy pierwszym uruchomieniu, abyśmy mogli poznać liczbę uruchomień wywołanych przez użytkownika.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Aplikacja uruchamiana z prezentacji powitalnej.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Zastosowano aplikację z panelu fokusu.

Metody

list

 Wyświetla listę zdarzeń telemetrycznych.