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