תוכלו לחפש מכשירים שתואמים למאפיינים מסוימים באמצעות השיטה 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.
ספריות לקוח מטפלות בקידוד כתובת אתר זה באופן אוטומטי.
חיפוש מכשירים שתואמים לקידומת של מספר סידורי
serial:525*
חיפוש מכשירים עם כתובת אימייל שמתחילה ב-fred
email:fred* email:contact*