Vous pouvez rechercher des appareils correspondant à certains attributs avec 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
comprend trois parties:
- Champ
- Attribut de l'appareil recherché. Exemple :
serial
. - Opérateur
- Test effectué sur les données pour établir une correspondance. Par exemple, l'opérateur
:
vérifie 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 reliées par un opérateur AND
.
Exemples
Toutes les requêtes utilisent la méthode mobiledevices.list
, qui génère une requête HTTP semblable à la suivante (des sauts de ligne sont inclus pour faciliter la lecture):
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 en tant qu'URL sous la forme query=brand%3goo*
.
Tous les exemples de cette page présentent des paramètres query
non encodés.
Les bibliothèques clientes gèrent automatiquement cet encodage des URL.
Rechercher des appareils correspondant à un préfixe de numéro de série
serial:525*
Rechercher des appareils dont l'adresse e-mail commence par fred
email:fred* email:contact*