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)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
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.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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 zdarzenia poważnego niedoboru danych audio. Występuje 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. Ładunek zdarzeń siły sygnału Wi-Fi. Występuje tylko wtedy, gdy atrybut 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. 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. Ładunek zdarzenia uruchomienia aplikacji.Występuje tylko wtedy, gdy eventType ma wartość APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Tylko dane wyjściowe. Ładunek zdarzenia dotyczącego awarii systemu operacyjnego. Występuje tylko wtedy, gdy eventType ma wartość OS_CRASH.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Tylko dane wyjściowe. Ładunek zdarzenia podłączenia lub odłączenia wyświetlacza zewnętrznego. Występuje tylko wtedy, gdy atrybut eventType ma wartość EXTERNAL_DISPLAY_CONNECTED lub EXTERNAL_DISPLAY_DISCONNECTED.

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 w przypadku urządzeń audio zabraknie danych w buforze na ponad 5 sekund.

  • Wymagane szczegółowe uprawnienie: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent jest wywoływane, gdy urządzenia USB są dodawane lub usuwane.

  • 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ływane przy zmianach stanu połączenia sieciowego.

  • 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 sieciowego.

TelemetryHttpsLatencyChangeEvent

Procedura sprawdzania opóźnienia protokołu HTTPS jest uruchamiana okresowo, a TelemetryHttpsLatencyChangeEvent jest wywoływane, jeśli wykryto problem z opóźnieniem lub jeśli urządzenie poradziło sobie z tym problemem.

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

object (HttpsLatencyRoutineData)

Dane procedury 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 na żądanie HTTPS wrócił do normy.
PROBLEM Problem z opóźnieniem HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent jest wywoływane 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 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 zależy od cyklu życia aplikacji.
appId

string

Identyfikator aplikacji. W przypadku aplikacji PWA jest to adres URL uruchamiania, 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 ChromeOS.
APPLICATION_INSTALL_SOURCE_SYNC Źródłem instalacji aplikacji jest 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

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 uznawana za jego część.
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 domyślnie zainstalowana, ale nie jest uważana za aplikację systemową.
APPLICATION_INSTALL_REASON_SYNC Aplikacja zainstalowana przez synchronizację.
APPLICATION_INSTALL_REASON_USER Aplikacja zainstalowana w wyniku działania użytkownika.
APPLICATION_INSTALL_REASON_SUB_APP Aplikacja zainstalowana przez wywołanie interfejsu SubApp API.
APPLICATION_INSTALL_REASON_KIOSK Aplikacja zainstalowana przez kiosk w ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplikacja zainstalowana za pomocą argumentu 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 Instalacja aplikacji została zainicjowana.
APPLICATION_INSTALL_TIME_RUNNING Instalacja aplikacji jest obecnie w toku.

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 PWA jest to adres URL uruchamiania, 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 (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 w ramach migracji aplikacji.

TelemetryAppLaunchEvent

Dane uruchamiania aplikacji.

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

enum (ApplicationLaunchSource)

Źródło uruchomienia aplikacji.
appId

string

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

enum (TelemetryApplicationType)

Typ aplikacji.

ApplicationLaunchSource

Opisuje źródło uruchomienia aplikacji.

Wartości w polu enum
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Źródło uruchomienia aplikacji jest nieznane.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Aplikacja została uruchomiona z siatki aplikacji, a nie z pola wyszukiwania.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplikacja została 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 w menu kontekstowym.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplikacja uruchomiona z rekomendacji bez zapytania (mniejsze ikony).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Aplikacja uruchomiona w sekcji Ustawienia kontroli rodzicielskiej i powiadomienie o czasie spędzonym w aplikacji.
APPLICATION_LAUNCH_SOURCE_SHELF Aplikacja została 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 w wyniku wewnętrznego wywołania w Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplikacja została uruchomiona za pomocą skrótu klawiszowego.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplikacja uruchomiona po kliknięciu linku w innej aplikacji lub interfejsie internetowym.
APPLICATION_LAUNCH_SOURCE_MENU Aplikacja została uruchomiona z menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplikacja została uruchomiona z powiadomienia o zainstalowaniu.
APPLICATION_LAUNCH_SOURCE_TEST Aplikacja została uruchomiona w ramach testu.
APPLICATION_LAUNCH_SOURCE_ARC Aplikacja uruchomiona z Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplikacja uruchomiona z arkusza udostępniania.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplikacja została uruchomiona z powiadomienia o informacjach o wersji.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplikacja została uruchomiona po pełnym przywróceniu.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplikacja uruchomiona z menu kontekstowego inteligentnego zaznaczania tekstu.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Aplikacja została uruchomiona z powiadomienia na karcie Discover.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplikacja uruchomiona z interfejsu API zarządzania Google Analytics.
APPLICATION_LAUNCH_SOURCE_KIOSK Aplikacja uruchomiona z kiosku.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplikacja uruchomiona 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 uruchomiona ze strony nowej karty.
APPLICATION_LAUNCH_SOURCE_INTENT_URL Aplikacja została uruchomiona z adresu URL intencji.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Aplikacja została 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 poziomu obsługi adresu URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplikacja została uruchomiona z menu z aplikacjami na ekranie blokady.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplikacja uruchomiona ze strony 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 instalowalnym interfejsie chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplikacja uruchomiona z kalendarza w obszarze powiadomień.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplikacja uruchomiona z instalatora źródłowego.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Oddzielnie zliczamy pierwsze uruchomienia aplikacji Pomoc, aby poznać liczbę uruchomień zainicjowanych przez użytkowników.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Aplikacja uruchomiona z poziomu przewodnika.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Aplikacja została uruchomiona z panelu ostrości.
APPLICATION_LAUNCH_SOURCE_SPARKY Aplikacja uruchomiona z funkcji eksperymentalnej Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Aplikacja uruchomiona z nawigacji.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Aplikacja uruchomiona za pomocą interfejsu API instalacji z internetu.

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 Nieznany typ awarii.
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 Nieznany typ sesji.
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.

TelemetryExternalDisplayEvent

Ładunek zdarzenia podłączenia lub odłączenia wyświetlacza zewnętrznego.

Zapis JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Pola
externalDisplayData[]

object (TelemetryExternalDisplayData)

Lista podłączonych i odłączonych wyświetlaczy zewnętrznych.

TelemetryExternalDisplayData

Dane wyświetlacza zewnętrznego.

Zapis JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Pola
displayName

string

Wyświetlana nazwa.
resolutionHorizontal

integer

Rozdzielczość pozioma.
resolutionVertical

integer

Rozdzielczość pionowa.
refreshRate

string (int64 format)

Częstotliwość odświeżania.
serialNumber

integer

Numer seryjny.
edidVersion

string

Wersja EDID.

Metody

list

 Wyświetlanie zdarzeń telemetrycznych.