يمكنك البحث عن أجهزة تتطابق مع سمات معيّنة باستخدام طريقة mobiledevices.list
في Directory API. تقبل هذه الطريقة المعلَمة 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*
البحث عن أجهزة تستخدم عنوان بريد إلكتروني يبدأ بـ سامي
email:fred* email:contact*