Rechercher appareils

Vous pouvez rechercher des appareils correspondant à certains attributs à l'aide de la méthode mobiledevices.list de l'API Directory. Cette méthode accepte le paramètre query, qui est une requête de recherche combinant une ou plusieurs clauses de recherche. Chaque clause de recherche se compose de trois parties :

Champ

Attribut de l'appareil recherché. Exemple :serial

Opérateur

Test

effectué sur les données pour fournir une correspondance. Par exemple, l'opérateur : teste si un attribut de texte correspond à une valeur.

Valeur

 : contenu de l'attribut testé. Exemple :serialNumber

Plusieurs clauses sont séparées par un espace blanc et sont implicitement jointes par un opérateur AND.

Remarque : La plupart des données sur les appareils sont actualisées sous une heure. Toutefois, un délai de 36 heures peut être nécessaire avant que les nouvelles données apparaissent dans tous les résultats de recherche.

Exemples

Toutes les requêtes utilisent la méthode mobiledevices.list, qui comporte une requête HTTP semblable à la suivante (sauts de ligne inclus pour la lisibilité) :

GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters

Les paramètres query doivent être encodés au format URL. Par exemple, la requête query=brand:goo* est encodée au format URL sous la forme query=brand%3goo*. Tous les exemples de cette page montrent des paramètres query non encodés. Les bibliothèques clientes gèrent automatiquement cet encodage d'URL.

Rechercher des appareils correspondant à un préfixe de numéro de série

serial:525*

Rechercher les appareils dont l'adresse e-mail commence par "fred"

email:fred* email:contact*

Remarque : Pour obtenir la liste complète des champs d'appareils mobiles, consultez Champs de recherche des appareils personnels.