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
:
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 des espaces blancs et sont jointes implicitement par un opérateur AND
.
Exemples
Toutes les requêtes utilisent la méthode mobiledevices.list
, qui comporte une requête HTTP semblable à la suivante (les sauts de ligne sont inclus pour plus de 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 présentent 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 des appareils avec une adresse e-mail commençant par "fred"
email:fred* email:contact*