คุณสามารถค้นหาอุปกรณ์ที่ตรงกับแอตทริบิวต์บางอย่างด้วยเมธอด 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*