Mit der Methode mobiledevices.list der Directory API können Sie nach Geräten suchen, die mit bestimmten Attributen übereinstimmen. Die Methode akzeptiert den Parameter query, bei dem es sich um eine Suchanfrage handelt, die eine oder mehrere Suchklauseln kombiniert. Jede Suchklausel
besteht aus drei Teilen:
- Field
- Gesuchtes Geräteattribut. Beispiel:
serial. - Betreiber
- Einen Test, der mit den Daten durchgeführt wird, um eine Übereinstimmung zu erzielen. Beispielsweise testet der Operator
:, 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 verbunden.
Beispiele
Bei allen Abfragen wird die Methode mobiledevices.list verwendet, für die eine HTTP-Anfrage ähnlich der folgenden ist (Zeilenumbrüche zur besseren Lesbarkeit eingefügt):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Die query-Parameter müssen URL-codiert sein. Die Abfrage query=brand:goo* ist beispielsweise URL-codiert als query=brand%3goo*.
Alle Beispiele auf dieser Seite zeigen nicht codierte query-Parameter.
Clientbibliotheken führen diese URL-Codierung automatisch durch.
Nach Geräten mit einem Seriennummernpräfix suchen
serial:525*
Nach Geräten suchen, deren E-Mail-Adresse mit fred beginnt
email:fred* email:contact*