Method: customers.telemetry.devices.list

Elenca tutti i dispositivi di telemetria.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

obbligatorio. ID cliente o "my_customer" (mio_cliente) per utilizzare il cliente associato all'account che ha effettuato la richiesta.

Parametri di ricerca

Parametri
filter

string

Campo facoltativo. Includi solo le risorse che corrispondono al filtro. Per impostazione predefinita, le richieste che non specificano un valore "reports_timestamp" restituiranno solo i report recenti. Specifica "reports_timestamp>=0" per ottenere tutti i dati del report.

Campi filtro supportati:

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
Il filtro "reports_timestamp" accetta il formato millisecondi Unix Epoch o il formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Entrambi i formati devono essere racchiusi tra virgolette semplici. Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string (FieldMask format)

obbligatorio. Maschera di lettura per specificare quali campi restituire.

I percorsi readMask supportati sono:

  • nome
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

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

pageSize

integer

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

pageToken

string

Token per specificare la pagina successiva nell'elenco.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

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

Rappresentazione JSON
{
  "devices": [
    {
      object (TelemetryDevice)
    }
  ],
  "nextPageToken": string
}
Campi
devices[]

object (TelemetryDevice)

Dispositivi di telemetria restituiti nella risposta.

nextPageToken

string

Token per specificare la pagina successiva nell'elenco.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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