Mit der Methode mobiledevices.list der Directory API können Sie nach Geräten suchen, die bestimmten Attributen entsprechen. Für diese Methode ist der Parameter query zulässig. Dabei handelt es sich um eine Suchanfrage, die eine oder mehrere Suchklauseln kombiniert. Jede Suchklausel besteht aus drei Teilen:
- Feld
- Geräteattribut, nach dem gesucht wird. Beispiel:
serial. - Operator
- Test, der an den Daten ausgeführt wird, um eine Übereinstimmung zu ermitteln. Mit dem Operator
:wird beispielsweise geprüft, ob ein Textattribut mit einem Wert übereinstimmt. - Wert
- Der Inhalt des getesteten Attributs. Beispiel:
serialNumber.
Mehrere Klauseln werden durch Leerzeichen getrennt und implizit durch einen AND-Operator verknüpft.
Beispiele
Für alle Abfragen wird die Methode mobiledevices.list verwendet. Die zugehörige HTTP-Anfrage sieht in etwa so aus (Zeilenumbrüche zur besseren Lesbarkeit):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Die query-Parameter müssen URL-codiert sein. Die Suchanfrage query=brand:goo* wird beispielsweise als query=brand%3goo* URL-codiert.
Alle Beispiele auf dieser Seite enthalten nicht codierte query-Parameter.
Clientbibliotheken verarbeiten diese URL-Codierung automatisch.
Nach Geräten mit einem bestimmten Seriennummernpräfix suchen
serial:525*
Nach Geräten mit E-Mail-Adressen suchen, die mit „max“ beginnen
email:fred* email:contact*