Method: customers.telemetry.events.list

Wyświetla listę zdarzeń telemetrycznych.

Żądanie HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Identyfikator klienta lub „my_customer”, aby użyć klienta powiązanego z kontem, z którego wysłano prośbę.

Parametry zapytania

Parametry
filter

string

Opcjonalnie. Uwzględnij tylko zasoby pasujące do filtra. Obecnie ten parametr jest opcjonalny, ale będzie wymagany – określ co najmniej 1 typ zdarzenia.

Obsługiwane pola filtrów:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • sygnatura czasowa
  • eventType
Filtr „sygnatura czasowa” może mieć format milisekund uniksowych lub format „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Oba formaty należy umieścić w cudzysłowie prostym. Przykłady: „2014-10-02T15:01:23Z”, „2014-10-02T15:01:23.045123456Z”, „1679283943823”.

readMask

string (FieldMask format)

To pole jest wymagane. Odczytaj maskę, aby określić, które pola zwrócić. Chociaż obecnie to pole jest wymagane, stanie się opcjonalne, natomiast parametr filtra z typem zdarzenia będzie wymagany.

Obsługiwane ścieżki readMask to:

  • urządzenie
  • użytkownik
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".

pageSize

integer

Opcjonalnie. Maksymalna liczba wyników do zwrócenia. Wartość domyślna to 100. Maksymalna wartość to 1000.

pageToken

string

Opcjonalnie. Token określający następną stronę na liście.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat z odpowiedzią na wyświetlanie listy zdarzeń telemetrycznych klienta.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
Pola
telemetryEvents[]

object (TelemetryEvent)

Zdarzenia telemetryczne zwrócone w odpowiedzi.

nextPageToken

string

Token określający następną stronę na liście.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly