Method: customers.telemetry.events.list

Telemetrieereignisse auflisten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Kundennummer oder „my_customer“, um den Kunden zu verwenden, der mit dem Konto verknüpft ist, von dem die Anfrage stammt.

Abfrageparameter

Parameter
filter

string

Optional. Schließen Sie nur Ressourcen ein, die dem Filter entsprechen. Dieser Parameter ist derzeit optional, er ist aber erforderlich. Geben Sie mindestens einen Ereignistyp an.

Unterstützte Filterfelder:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
Der Filter „timestamp“ akzeptiert entweder das Format Unix-Epochen-Millisekunden oder das RFC3339-UTC-Format „Zulu“ mit Nanosekunden-Auflösung und bis zu neun Nachkommastellen. Beide Formate sollten in einfache doppelte Anführungszeichen gesetzt werden. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“, „1679283943823“.

readMask

string (FieldMask format)

Erforderlich. Lesemaske, um festzulegen, welche Felder zurückgegeben werden sollen. Dieses Feld ist zwar derzeit erforderlich, wird jedoch optional, während der Filterparameter mit einem Ereignistyp ein Pflichtfeld sein wird.

Unterstützte readMask-Pfade sind:

  • Gerät
  • Nutzer
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

pageSize

integer

Optional. Maximale Anzahl der zurückzugebenden Ergebnisse; Der Standardwert ist 100. Der Höchstwert beträgt 1.000.

pageToken

string

Optional. Token zur Angabe der nächsten Seite in der Liste.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht zum Auflisten von Telemetrieereignissen für einen Kunden.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
Felder
telemetryEvents[]

object (TelemetryEvent)

In der Antwort zurückgegebene Telemetrieereignisse.

nextPageToken

string

Token zur Angabe der nächsten Seite in der Liste.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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