Bạn có thể tìm kiếm các thiết bị khớp với một số thuộc tính nhất định bằng phương thức mobiledevices.list của Directory API. Phương thức này chấp nhận tham số query. Đây là một cụm từ tìm kiếm kết hợp một hoặc nhiều mệnh đề tìm kiếm. Mỗi mệnh đề tìm kiếm bao gồm 3 phần:
- Trường
- Thuộc tính thiết bị được tìm kiếm. Ví dụ:
serial. - Đơn vị tổ chức
- Các thử nghiệm được thực hiện trên dữ liệu để cung cấp kết quả trùng khớp. Chẳng hạn, toán tử
:sẽ kiểm tra xem thuộc tính văn bản có khớp với một giá trị hay không. - Giá trị
- Nội dung của thuộc tính được kiểm thử. Ví dụ:
serialNumber.
Nhiều mệnh đề được phân tách bằng khoảng trắng và được kết hợp ngầm bằng toán tử AND.
Ví dụ
Tất cả truy vấn đều sử dụng phương thức mobiledevices.list. Phương thức này có yêu cầu HTTP tương tự như sau (có phần ngắt dòng để dễ đọc):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
Tham số query phải được mã hoá URL. Ví dụ: truy vấn query=brand:goo* được mã hoá dưới dạng query=brand%3goo*.
Tất cả ví dụ trên trang này đều cho thấy tham số query chưa được mã hoá.
Thư viện ứng dụng sẽ tự động xử lý việc mã hoá URL này.
Tìm thiết bị khớp với một tiền tố của số sê-ri
serial:525*
Tìm thiết bị có email bắt đầu bằng fred
email:fred* email:contact*