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