Mit der Methode mobiledevices.list der Directory API können Sie nach Geräten suchen, die bestimmten Attributen entsprechen. Diese Methode akzeptiert den Parameter query, der eine Suchanfrage mit einer oder mehreren Suchklauseln ist. 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 finden. Mit dem Operator
:wird beispielsweise geprüft, ob ein Textattribut mit einem Wert übereinstimmt. - Wert
- Der Inhalt des Attributs, das getestet wird. Beispiel:
serialNumber.
Mehrere Klauseln werden durch Leerzeichen getrennt und implizit durch einen AND-Operator verknüpft.
Beispiele
Für alle Anfragen wird die Methode mobiledevices.list verwendet. Die entsprechende HTTP-Anfrage sieht 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 Anfrage query=brand:goo* wird beispielsweise als query=brand%3goo* URL-codiert.
In allen Beispielen auf dieser Seite werden nicht codierte query-Parameter verwendet.
Clientbibliotheken übernehmen diese URL-Codierung automatisch.
Nach Geräten suchen, die mit einem Seriennummernpräfix übereinstimmen
serial:525*
Suche nach Geräten mit E‑Mail-Adressen, die mit „fred“ beginnen
email:fred* email:contact*