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)
  }
}
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.

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.

Metody

list

 Wyświetla listę zdarzeń telemetrycznych.