Method: chromeosdevices.list

Récupère une liste paginée des appareils Chrome OS au sein d'un compte.

Requête HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter customerId de votre compte. Le customerId est également renvoyé dans le cadre de la ressource Users.

Paramètres de requête

Paramètres
maxResults

integer

Nombre maximal de résultats à renvoyer (la valeur ne doit pas dépasser 300).
orderBy

enum (OrderBy)

Propriété de l'appareil à utiliser pour trier les résultats.
orgUnitPath

string

Chemin d'accès complet de l'unité organisationnelle (moins la / de début) ou son identifiant unique.
pageToken

string

Le paramètre de requête pageToken permet de demander la page suivante des résultats de requête. Le paramètre de requête pageToken de la requête suivante est nextPageToken de votre réponse précédente.
projection

enum (Projection)

Détermine si la réponse contient la liste complète des propriétés ou seulement un sous-ensemble.
query

string

Chaîne de recherche au format indiqué sur la page https://developers.google.com/admin-sdk/directory/v1/list-query-operators
sortOrder

enum (SortOrder)

Indique si les résultats doivent être renvoyés par ordre croissant ou décroissant. Doit être utilisé avec le paramètre orderBy.
includeChildOrgunits

boolean

Renvoie les appareils de toutes les unités organisationnelles enfants, ainsi que de l'unité organisationnelle spécifiée. Si cette règle est définie sur "true", "orgUnitPath" doit être indiqué.

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 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Type de ressource dont il s'agit.
etag

string

ETag de la ressource.
chromeosdevices[]

object (ChromeOsDevice)

Liste des objets d'appareils Chrome OS.
nextPageToken

string

Jeton utilisé pour accéder à la page suivante de ce résultat. Pour accéder à la page suivante, utilisez la valeur de ce jeton dans la chaîne de requête pageToken de cette requête.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

Pour en savoir plus, consultez le Guide relatif aux autorisations.

OrderBy

Enums
ANNOTATED_LOCATION Position de l'appareil Google Chrome annotée par l'administrateur
ANNOTATED_USER Utilisateur Chromebook annoté par l'administrateur.
LAST_SYNC Date et heure de la dernière synchronisation des paramètres de règles entre l'appareil Chrome et la console d'administration.
NOTES Notes de l'appareil Chrome annotées par l'administrateur
SERIAL_NUMBER Numéro de série de l'appareil Chrome saisi lors de son activation.
STATUS État de l'appareil Google Chrome Pour en savoir plus, consultez <a chromeosdevices.

Projection

Type de projection à afficher pour les appareils.

Enums
BASIC Inclut uniquement les champs de métadonnées de base (par exemple, deviceId, serialNumber, status et user)
FULL Inclut tous les champs de métadonnées

SortOrder

Ordre de tri à appliquer à la liste des appareils.

Enums
ASCENDING Ordre croissant.
DESCENDING Ordre décroissant.