Anda dapat mencari perangkat yang cocok dengan atribut tertentu dengan metode mobiledevices.list dari Directory API. Metode ini menerima parameter query, yaitu kueri penelusuran yang menggabungkan satu atau beberapa klausa penelusuran. Setiap klausa pencarian terdiri
dari tiga bagian:
- Kolom
- Atribut perangkat yang ditelusuri. Misalnya,
serial. - Operator
- Pengujian yang dilakukan pada data untuk memberikan kecocokan. Misalnya, operator
:menguji apakah atribut teks cocok dengan nilai. - Nilai
- Konten atribut yang diuji. Misalnya,
serialNumber.
Beberapa klausa dipisahkan dengan spasi kosong dan secara implisit digabungkan oleh
operator AND.
Contoh
Semua kueri menggunakan metode mobiledevices.list, yang memiliki permintaan HTTP yang mirip dengan berikut ini (baris baru disertakan agar mudah dibaca):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Parameter query harus dienkode ke URL. Misalnya, kueri
query=brand:goo* adalah URL yang dienkode sebagai query=brand%3goo*.
Semua contoh di halaman ini menampilkan parameter query yang tidak dienkode.
Library klien menangani encoding URL ini secara otomatis.
Telusuri perangkat yang cocok dengan awalan nomor seri
serial:525*
Menelusuri perangkat dengan email yang diawali dengan fred
email:fred* email:contact*