REST Resource: customers.telemetry.events

Zasób: TelemetryEvent

Dane telemetryczne przesyłane 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)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
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 wskazuje, kiedy zdarzenie zostało zgłoszone.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

Typ bieżącego zdarzenia.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Tylko dane wyjściowe. Ładunek dla zdarzenia poważnego niedoboru czasu reklamy audio. Wyświetlane tylko wtedy, gdy pole eventType ma wartość AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Tylko dane wyjściowe. Ładunek zdarzenia dotyczącego urządzeń peryferyjnych USB. Występuje 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; Występuje tylko wtedy, gdy eventType ma wartość NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

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

object (TelemetryNetworkSignalStrengthEvent)

Tylko dane wyjściowe. Dane ładunku dla zdarzeń siły sygnału Wi-Fi. Występuje tylko wtedy, gdy eventType ma wartość WIFI_SIGNAL_STRENGTH_LOW lub WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Tylko dane wyjściowe. Dane payload dla zdarzenia zmiany stanu połączenia VPN. Występuje tylko wtedy, gdy eventType ma wartość VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

Tylko dane wyjściowe. Dane ładunku zdarzenia uruchamiania aplikacji.Występują tylko wtedy, gdy eventType to APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Tylko dane wyjściowe. Ładunek zdarzenia awarii w systemie operacyjnym. Występuje tylko wtedy, gdy eventType ma wartość OS_CRASH.

TelemetryDeviceInfo

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

  • Wymagane szczegółowe uprawnienie: 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.

  • Wymagane szczegółowe uprawnienie: 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 pól.

TelemetryAudioSevereUnderrunEvent jest wywoływany, gdy urządzenia audio nie mają danych buforowych przez ponad 5 sekund.

  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent jest aktywowane, gdy dodawane lub usuwane są urządzenia USB.

  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_PERIPHERALS_REPORT
Zapis JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Pola
usbPeripheralReport[]

object (UsbPeripheralReport)

Lista urządzeń USB, które zostały dodane lub usunięte.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent jest wywoływany w przypadku zmian stanu połączenia z siecią.

  • Wymagane szczegółowe uprawnienie: 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 z siecią.

TelemetryHttpsLatencyChangeEvent

Rutyna dotycząca opóźnień w sieć powoduje okresowe uruchamianie się TelemetryHttpsLatencyChangeEvent, jeśli zostanie wykryty problem z opóźnieniem lub jeśli urządzenie powróci do normalnego stanu.

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

object (HttpsLatencyRoutineData)

Dane dotyczące 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 Opóźnienie HTTPS zostało rozwiązane.
PROBLEM Problem z opóźnieniem HTTPS.

TelemetryNetworkSignalStrengthEvent

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

  • Wymagane szczegółowe uprawnienie: 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 o instalacjach 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 zależy od jej cyklu życia.
appId

string

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

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationInstallSource

Wskazuje ź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ło instalacji aplikacji to przeglądarka.

ApplicationInstallReason

Wskazuje powód instalacji aplikacji.

Wartości w polu enum
APPLICATION_INSTALL_REASON_UNSPECIFIED Przyczyna instalacji aplikacji jest nieznana.
APPLICATION_INSTALL_REASON_SYSTEM Aplikacja zainstalowana wraz z systemem i uważana za część systemu operacyjnego.
APPLICATION_INSTALL_REASON_POLICY Aplikacja zainstalowana na podstawie zasad.
APPLICATION_INSTALL_REASON_OEM Aplikacja zainstalowana przez producenta oryginalnego sprzętu (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Aplikacja zainstalowana domyślnie, ale nie jest uważana za aplikację systemową.
APPLICATION_INSTALL_REASON_SYNC Aplikacja zainstalowana przez synchronizację.
APPLICATION_INSTALL_REASON_USER Aplikacja została zainstalowana przez użytkownika.
APPLICATION_INSTALL_REASON_SUB_APP Aplikacja zainstalowana przez wywołanie interfejsu API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Aplikacja zainstalowana przez Kiosk na ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplikacja zainstalowana za pomocą 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 Inicjowanie instalacji aplikacji.
APPLICATION_INSTALL_TIME_RUNNING Instalacja aplikacji jest w trakcie.

TelemetryAppUninstallEvent

Dane o odinstalowaniu 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 PWAs jest to adres URL początkowy, a w przypadku rozszerzeń – identyfikator rozszerzenia.
appType

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationUninstallSource

Wskazuje ź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 (Menu z aplikacjami).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Aplikacja została odinstalowana na stronie Zarządzanie aplikacjami.
APPLICATION_UNINSTALL_SOURCE_SHELF Aplikacja została odinstalowana z półki.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Aplikacja została odinstalowana podczas migracji.

TelemetryAppLaunchEvent

Dane o uruchamianiu 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 PWAs jest to adres URL początkowy, a w przypadku rozszerzeń – 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 uruchomienia aplikacji jest nieznane.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Aplikacja uruchomiona z siatki aplikacji, a nie z pola wyszukiwania.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplikacja uruchomiona z siatki aplikacji, a nie z menu kontekstowego.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Aplikacja uruchomiona z wyników zależnych od zapytania (większe ikony).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Aplikacja uruchomiona z wyników zależnych od zapytania, poza menu kontekstowym.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplikacja uruchomiona z rekomendacji bez zapytania (mniejsze ikony).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Aplikacja uruchomiona z sekcji Ustawienia kontroli rodzicielskiej i powiadomienia dotyczące czasu korzystania z aplikacji.
APPLICATION_LAUNCH_SOURCE_SHELF Aplikacja uruchomiona z półki.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplikacja uruchomiona z menedżera plików
APPLICATION_LAUNCH_SOURCE_OMNIBOX Aplikacja uruchomiona po wpisaniu adresu URL w omniboksie w przeglądarce.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplikacja uruchomiona z wewnętrznego wywołania Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplikacja uruchamiana za pomocą skrótu klawiszowego.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplikacja uruchomiona po kliknięciu linku w innej aplikacji lub w interfejsie internetowym.
APPLICATION_LAUNCH_SOURCE_MENU Aplikacja uruchomiona z menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplikacja uruchomiona z zainstalowanego powiadomienia.
APPLICATION_LAUNCH_SOURCE_TEST Aplikacja uruchomiona z testu.
APPLICATION_LAUNCH_SOURCE_ARC Aplikacja uruchomiona z Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplikacja uruchomiona z panelu udostępniania.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplikacja uruchomiona z powiadomienia z informacjami o wersji.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplikacja uruchomiona po pełnym przywróceniu.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplikacja uruchomiona z menu kontekstowego inteligentego zaznaczania tekstu.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Aplikacja uruchomiona z powiadomienia na karcie Discover.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplikacja uruchomiona z interfejsu Management API.
APPLICATION_LAUNCH_SOURCE_KIOSK Aplikacja uruchomiona z kiosku.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplikacja uruchomiona z poziomu wiersza poleceń.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Aplikacja uruchomiona w tle.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Aplikacja uruchomiona na stronie nowej karty.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Aplikacja uruchomiona z adresu URL zamiaru.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Aplikacja uruchomiona z poziomu logowania do systemu operacyjnego.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplikacja uruchomiona z modułu obsługi protokołu.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplikacja uruchomiona z użyciem modułu obsługi adresu URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplikacja uruchomiona z menu z aplikacjami na ekranie blokady.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplikacja uruchomiona na stronie głównej aplikacji (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplikacja uruchomiona po przeniesieniu treści do aplikacji.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Aplikacja uruchomiona z menu profilu w interfejsie internetowym chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplikacja uruchomiona z poziomu obszaru powiadomień kalendarza.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplikacja uruchomiona z instalatora źródłowego.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Liczba pierwszych uruchomień aplikacji pomocy jest zliczana osobno, abyśmy mogli określić liczbę uruchomień wywołanych przez użytkownika.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Aplikacja uruchomiona z poziomu prezentacji powitalnej.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Aplikacja uruchomiona z panelu ostrości.
APPLICATION_LAUNCH_SOURCE_SPARKY Aplikacja uruchomiona z funkcji eksperymentalnej Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Aplikacja uruchomiona z wykorzystaniem rejestrowania nawigacji.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Aplikacja uruchomiona z interfejsu API do instalowania aplikacji internetowych.

TelemetryOsCrashEvent

Dane o awariach systemu operacyjnego.

Zapis JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Pola
crashType

enum (CrashType)

Typ awarii.
sessionType

enum (SessionType)

Typ sesji.
crashId

string

Identyfikator awarii.

CrashType

Opisuje typ awarii.

Wartości w polu enum
CRASH_TYPE_UNSPECIFIED Typ awarii jest nieznany.
CRASH_TYPE_KERNEL Awaria jądra.
CRASH_TYPE_EMBEDDED_CONTROLLER Awaria wbudowanego kontrolera.

SessionType

Opisuje typ sesji.

Wartości w polu enum
SESSION_TYPE_UNSPECIFIED Typ sesji jest nieznany.
SESSION_TYPE_SIGNED_IN_USER Zalogowany użytkownik.
SESSION_TYPE_KIOSK Kiosk.
SESSION_TYPE_MANAGED_GUEST Zarządzana sesja gościa.
SESSION_TYPE_ACTIVE_DIRECTORY Sesja Active Directory.

Metody

list

 Lista zdarzeń telemetrycznych.