Method: customers.telemetry.events.list

Elenca gli eventi di telemetria.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. ID cliente o "mio_cliente" per utilizzare il cliente associato all'account che ha effettuato la richiesta.

Parametri di query

Parametri
filter

string

(Facoltativo) Includi solo le risorse che corrispondono al filtro. Anche se al momento è facoltativo, questo parametro sarà obbligatorio. Specifica almeno un tipo di evento.

Campi filtro supportati:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
Il filtro "timestamp" accetta il formato millisecondi Unix epoch o il formato "Zulu" UTC RFC3339 con risoluzione a nanosecondi e fino a nove cifre decimali. Entrambi i formati devono essere racchiusi tra virgolette doppie semplici. Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string (FieldMask format)

Obbligatorio. Maschera di lettura per specificare i campi da restituire. Anche se attualmente obbligatorio, questo campo diventerà facoltativo, mentre il parametro di filtro con un tipo di evento diventerà obbligatorio.

I percorsi readMask supportati sono:

  • dispositivo
  • utente
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

pageSize

integer

(Facoltativo) Numero massimo di risultati da restituire. Il valore predefinito è 100. Il valore massimo è 1000.

pageToken

string

(Facoltativo) Token per specificare la pagina successiva dell'elenco.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per elencare gli eventi di telemetria per un cliente.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
Campi
telemetryEvents[]

object (TelemetryEvent)

Eventi di telemetria restituiti nella risposta.

nextPageToken

string

Token per specificare la pagina successiva dell'elenco.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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