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 requête.

Paramètres de requête

Paramètres
filter

string

Facultatif. N'incluez que les ressources qui correspondent au filtre. Les requêtes qui ne spécifient pas de valeur "reports_timestamp" ne renvoient que les rapports récents par défaut. Spécifiez "reports_timestamp>=0" pour obtenir toutes les données de rapport.

Champs de filtre compatibles:

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
Le filtre "reports_timestamp" accepte le format en millisecondes de l'époque Unix ou le format UTC "Zulu" RFC3339, avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 permettant de spécifier les champs à renvoyer.

Les chemins 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 de 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