يمكنك البحث عن أجهزة تتطابق مع سمات معيّنة باستخدام طريقة 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*