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 jest domyślnie połączonych operatorem AND.
Przykłady
Wszystkie zapytania korzystają z metody mobiledevices.list, która ma żądanie HTTP podobne do tego (przerwy w wierszach dodano w celu ułatwienia odczytania):
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
email:fred* email:contact*