Method: customers.telemetry.devices.list

Répertoriez 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. Numéro 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. N'incluez que les ressources correspondant au filtre. Requêtes qui ne spécifient pas de "reports_timestamp" valeur par défaut renvoie uniquement les 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
. "reports_timestamp" Le filtre accepte le format de millisecondes epoch Unix ou le format RFC3339 UTC "Zulu" avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Les deux formats doivent être entourés de guillemets. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string (FieldMask format)

Obligatoire. Masque de lecture pour spécifier les champs à renvoyer.

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

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