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*