Method: customers.telemetry.devices.list

Lister tous les appareils de télémétrie

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Identifiant client ou "my_customer" pour utiliser le client associé au compte à l'origine de la demande.

Paramètres de requête

Paramètres
filter

string

Facultatif. Incluez uniquement les ressources correspondant au filtre. Les requêtes qui ne spécifient pas de valeur "reports_timestamp" renvoient par défaut uniquement des rapports récents. Spécifiez "reports_timestamp>=0" pour obtenir toutes les données du rapport.

Champs de filtre compatibles:

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
Le filtre "reports_timestamp" accepte le format de millisecondes Unix Epoch ou le format RFC3339 UTC "Zulu" avec une résolution de la nanoseconde et jusqu'à neuf chiffres décimaux. Les deux formats doivent être entourés de guillemets simples. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".
readMask

string (FieldMask format)

Obligatoire. Lire le masque pour spécifier les champs à renvoyer.

Les chemins d'accès readMask compatibles sont les suivants:

  • name
  • 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

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
pageSize

integer

Nombre maximal de résultats sur une page. La valeur par défaut est 100. La valeur maximale est de 1 000.
pageToken

string

Jeton permettant de spécifier la page suivante dans la liste.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :

Représentation JSON 
{
  "devices": [
    {
      object (TelemetryDevice)
    }
  ],
  "nextPageToken": string
}
Champs
devices[]

object (TelemetryDevice)

Appareils de télémétrie renvoyés dans la réponse.
nextPageToken

string

Jeton permettant de spécifier la page suivante dans la liste.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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