Urządzenia pasujące do określonych atrybutów możesz wyszukiwać za pomocą metody mobiledevices.list interfejsu Directory API. Ta metoda akceptuje parametr query, który jest zapytaniem wyszukiwania zawierającym co najmniej 1 klauzulę wyszukiwania. Każda klauzula wyszukiwania składa się z 3 części:
Pole
Atrybut urządzenia, który jest wyszukiwany. Na przykład: serial.
Operator
Test wykonywany na danych w celu zapewnienia dopasowania. Na przykład operator :sprawdza, czy atrybut tekstowy pasuje do wartości.
Wartość
Treści atrybutu, który jest testowany. Na przykład: serialNumber.
Wiele klauzul jest oddzielonych od siebie spacjami i domyślnie połączonych operatorem AND.
Przykłady
Wszystkie zapytania używają metody mobiledevices.list, która ma żądanie HTTP podobne do tego (przerwy między wierszami w celu ułatwienia czytelności):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Parametry query muszą być zakodowane na potrzeby adresu URL. Na przykład zapytanie query=brand:goo* jest zakodowane w formacie adresu URL jako query=brand%3goo*.
Wszystkie przykłady na tej stronie zawierają niezakodowane parametry query.
Biblioteki klienta automatycznie obsługują kodowanie adresów URL.
Wyszukaj urządzenia pasujące do prefiksu numeru seryjnego
serial:525*
Wyszukaj urządzenia, których adres e-mail zaczyna się od fred
[null,null,["Ostatnia aktualizacja: 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"]]
