אפשר לחפש מכשירים שתואמים למאפיינים מסוימים באמצעות השיטה
mobiledevices.list
של Directory API. ה-method הזה מקבל את הפרמטר query, שהוא שאילתת חיפוש שמשלבת סעיף חיפוש אחד או יותר. כל פסקה של חיפוש מורכבת משלושה חלקים:
- שדה
- מאפיין המכשיר שמחפשים. לדוגמה,
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*