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 |
Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias |
Paramètres de requête
Paramètres | |
---|---|
maxResults |
Nombre maximal de résultats sur une page. La valeur ne doit pas dépasser 300. |
orderBy |
Propriété de l'appareil à utiliser pour trier les résultats. |
orgUnitPath |
Chemin d'accès complet de l'unité organisationnelle (moins la |
pageToken |
Le paramètre de requête |
projection |
Détermine si la réponse contient la liste complète des propriétés ou seulement un sous-ensemble. |
query |
Chaîne de recherche au format indiqué sur la page https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
Indique si les résultats doivent être renvoyés par ordre croissant ou décroissant. Doit être utilisé avec le paramètre |
includeChildOrgunits |
Renvoie les appareils de toutes les unités organisationnelles enfants, ainsi que de l'unité organisationnelle spécifiée. Si la valeur est "true", "orgUnitPath" doit être fourni. |
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 ( |
Champs | |
---|---|
kind |
Type de ressource dont il s'agit. |
etag |
ETag de la ressource. |
chromeosdevices[] |
Liste des objets d'appareils Chrome OS. |
nextPageToken |
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 |
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 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. |