Method: chromeosdevices.list

Récupère une liste paginée des appareils Chrome OS 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 le customerId de votre compte. Le customerId est également renvoyé dans la ressource "Users".

Paramètres de requête

Paramètres
maxResults

integer

Nombre maximal de résultats sur une page.

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 valeur / initiale) ou de son identifiant unique.

pageToken

string

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

projection

enum (Projection)

Limitez les informations renvoyées à un ensemble de champs sélectionnés.

query

string

Chaîne de recherche au format indiqué à l'adresse https://developers.google.com/admin-sdk/directory/v1/list-query-operators

sortOrder

enum (SortOrder)

Indique si les résultats doivent être affichés dans l'ordre croissant ou décroissant. Doit être utilisé avec le paramètre orderBy.

includeChildOrgunits

boolean

Affiche les appareils de toutes les unités organisationnelles enfants, ainsi que de l'unité organisationnelle spécifiée. Si la valeur est "true", vous devez indiquer "orgUnitPath".

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 Chrome OS Device.

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 Emplacement de l'appareil Chrome, comme indiqué par l'administrateur
ANNOTATED_USER Utilisateur Chromebook annoté par l'administrateur.
LAST_SYNC Date et heure de la dernière synchronisation de l'appareil Chrome avec les paramètres des règles dans la console d'administration.
NOTES Notes relatives aux appareils Google Chrome, annotées par l'administrateur
SERIAL_NUMBER Numéro de série de l'appareil Chrome saisi lors de l'activation de l'appareil.
STATUS État de l'appareil Chrome. Pour en savoir plus, consultez les <a chromeosdevices.

Projection

Type de projection à afficher pour les appareils.

Enums
BASIC Comprend 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.