คุณจะค้นหาอุปกรณ์ที่ตรงกับแอตทริบิวต์บางอย่างได้โดยใช้เมธอด mobiledevices.list ของ Directory API เมธอดนี้ยอมรับพารามิเตอร์ query ซึ่งเป็นคำค้นหาที่รวมวลีการค้นหาอย่างน้อย 1 รายการ วลีการค้นหาแต่ละรายการประกอบด้วย 3 ส่วน ดังนี้
- ฟิลด์
- แอตทริบิวต์อุปกรณ์ที่ค้นหา เช่น
serial - ผู้ประกอบธุรกิจ
- ทดสอบซึ่งดำเนินการกับข้อมูลเพื่อให้ได้ผลลัพธ์ที่ตรงกัน เช่น โอเปอเรเตอร์
:จะทดสอบว่าแอตทริบิวต์ข้อความตรงกับค่าหรือไม่ - ค่า
- เนื้อหาของแอตทริบิวต์ที่ทดสอบ เช่น
serialNumber
วลีหลายรายการจะคั่นด้วยช่องว่างและรวมกันโดยปริยายด้วยโอเปอเรเตอร์ AND
ตัวอย่าง
คำค้นหาทั้งหมดจะใช้เมธอด mobiledevices.list ซึ่งมีคำขอ HTTP คล้ายกับข้อความต่อไปนี้ (มีการแบ่งบรรทัดเพื่อให้อ่านได้ง่าย)
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
พารามิเตอร์ query ต้องเป็น URL ที่เข้ารหัส ตัวอย่างเช่น คําค้นหา query=brand:goo* คือ URL ที่เข้ารหัสเป็น query=brand%3goo*
ตัวอย่างทั้งหมดในหน้านี้แสดงพารามิเตอร์ query ที่ไม่เข้ารหัส
ไลบรารีของไคลเอ็นต์จะจัดการการเข้ารหัส URL นี้โดยอัตโนมัติ
ค้นหาอุปกรณ์ที่ตรงกับคำนำหน้าหมายเลขซีเรียล
serial:525*
ค้นหาอุปกรณ์ที่มีอีเมลที่ขึ้นต้นด้วย fred
email:fred* email:contact*