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 |
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. |
orderBy |
Propriété de l'appareil à utiliser pour trier les résultats. |
orgUnitPath |
Chemin d'accès complet de l'unité organisationnelle (moins la valeur |
pageToken |
Le paramètre de requête |
projection |
Limitez les informations renvoyées à un ensemble de champs sélectionnés. |
query |
Chaîne de recherche au format indiqué à l'adresse https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
Indique si les résultats doivent être affichés dans l'ordre croissant ou décroissant. Doit être utilisé avec le paramètre |
includeChildOrgunits |
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 ( |
Champs | |
---|---|
kind |
Type de ressource dont il s'agit. |
etag |
ETag de la ressource. |
chromeosdevices[] |
Liste des objets Chrome OS Device. |
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 |
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. |