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, über das die Anfrage erfolgt.

Abfrageparameter

Parameter
filter

string

Optional. Fügen Sie nur Ressourcen hinzu, die dem Filter entsprechen. Dieser Parameter ist derzeit optional, wird aber bald erforderlich sein. Geben Sie daher mindestens einen Ereignistyp an.

Unterstützte Filterfelder:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
Der Filter „Zeitstempel“ akzeptiert entweder das Millisekundenformat der Unix-Epoche oder das Format „Zulu“ (UTC) von RFC 3339 mit einer Auflösung im Nanosekundenbereich 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, mit der angegeben wird, welche Felder zurückgegeben werden sollen. Dieses Feld ist derzeit erforderlich, wird aber optional. Der Filterparameter mit einem Ereignistyp wird dann erforderlich.

Folgende Pfade für readMask werden unterstützt:

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

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

pageSize

integer

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

pageToken

string

Optional. Token, um die nächste Seite in der Liste anzugeben.

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)

Telemetrieereignisse, die in der Antwort zurückgegeben werden.

nextPageToken

string

Token, um die nächste Seite in der Liste anzugeben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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