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 dem Konto zugeordnet ist, von dem die Anfrage stammt.

Suchparameter

Parameter
filter

string

Optional. Nur Ressourcen einbeziehen, die dem Filter entsprechen. Dieser Parameter ist derzeit optional, wird aber in Zukunft erforderlich sein. Geben Sie daher mindestens einen Ereignistyp an.

Unterstützte Filterfelder:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
 Der Filter „timestamp“ akzeptiert entweder das Unix-Epochenformat in Millisekunden oder das RFC3339-UTC-„Zulu“-Format mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beide Formate sollten von einfachen doppelten Anführungszeichen umschlossen sein. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“, „1679283943823“.

readMask

string (FieldMask format)

Erforderlich. Lesemaske, um anzugeben, welche Felder zurückgegeben werden sollen. Dieses Feld ist derzeit erforderlich, wird aber optional. Der Filterparameter mit einem Ereignistyp wird dann erforderlich.

Unterstützte readMask-Pfade:

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

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 beträgt 1.000.

pageToken

string

Optional. Token zum Angeben 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 zum Angeben der nächsten Seite in der Liste.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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