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 finden. 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 zeigen 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
[null,null,["Zuletzt aktualisiert: 2025-01-27 (UTC)."],[[["The `mobiledevices.list` method allows you to search for devices with specific attributes using a `query` parameter."],["A search query is built with clauses consisting of a field, operator, and value, separated by whitespace and implicitly joined by `AND`."],["Queries can use wildcards like `*` for partial matches and multiple clauses can be combined for more refined searches."],["It's important to note that data updates can take up to 36 hours to be reflected in search results."],["Refer to the \"Personal device search fields\" documentation for a complete list of searchable device attributes."]]],["The `mobiledevices.list` method in the Directory API allows searching for devices using the `query` parameter. A query consists of clauses: a Field (attribute), an Operator (test), and a Value (content). Clauses are implicitly joined by `AND`. For example, `serial:525*` searches for serial numbers starting with \"525\". Multiple fields can be used in a single query, such as `email:fred* email:contact*`. Queries are URL encoded, and client libraries manage this automatically. Data updates can take up to 36 hours to reflect in search results.\n"]]
