للبحث عن مجموعة معيّنة من مساحات التخزين السحابي المشتركة، استخدِم سلسلة طلب البحث q حقل
مع drives.list لفلترة مساحات التخزين السحابي التي تريد
عرضها من خلال دمج عبارة بحث واحدة أو أكثر.
تحتوي سلسلة طلب البحث على الأجزاء الثلاثة التالية:
query_term operator values
المكان:
query_termهي عبارة طلب البحث أو الحقل الذي يتم البحث فيه.تحدّد
operatorشرط عبارة الطلب.valuesهي القيم المحدّدة التي تريد استخدامها لفلترة نتائج البحث.
للاطّلاع على عبارات طلبات البحث وعوامل التشغيل التي يمكنك استخدامها لفلترة مساحات التخزين السحابي المشتركة، راجِع عبارات طلبات البحث وعوامل التشغيل.
على سبيل المثال، تصفِّر سلسلة طلب البحث التالية عملية البحث لعرض مساحات التخزين المشترَكة التي تحمل الاسم "موارد Google Drive API" فقط.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
أمثلة على سلاسل طلبات البحث
يسرد الجدول التالي أمثلة على بعض سلاسل الاستعلام الأساسية لمساحات التخزين السحابي المشتركة. يختلف الرمز الفعلي استنادًا إلى مكتبة البرامج التي تستخدمها للبحث.
يجب أيضًا إضافة أحرف إلغاء إلى الأحرف الخاصة في أسماء الملفات للتأكّد من أنّ
طلب البحث يعمل بشكل صحيح. على سبيل المثال، إذا كان اسم ملف يتضمّن كلاً من الشرطة المائلة للأمام
(') والشرطة المائلة للخلف ("\")، استخدِم الشرطة المائلة للخلف للترميز: name
contains 'quinn\'s paper\\essay'.
| ما تريد الاستعلام عنه | مثال | الإعداد useDomainAdminAccess |
|---|---|---|
| مساحات التخزين السحابي المشتركة التي تم إنشاؤها بعد 1 حزيران (يونيو) 2017 | createdTime > '2017-06-01T12:00:00' |
true |
| مساحات التخزين السحابي المشتركة الظاهرة في العرض التلقائي | hidden = false |
false |
| مساحات التخزين السحابي المشتركة التي تضم أكثر من عضو واحد | memberCount > 1 |
true |
| مساحات التخزين السحابي المشتركة التي تحتوي على كلمة "سرية" في العنوان و20 عضوًا أو أكثر | name contains 'confidential' and memberCount >= 20 |
true |
| مساحات التخزين السحابي المشتركة مع الكلمة "سرية" في العنوان بين جميع مساحات التخزين السحابي المشتركة للمؤسسة | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| مساحات التخزين السحابي المشتركة التي تحتوي على كلمة "سرية" في العنوان من بين جميع مساحات التخزين السحابي المشتركة التي يكون المستخدم عضوًا فيها | name contains 'confidential' |
false |
| مساحات التخزين السحابي المشتركة التي لم يتم تعيين منظِّم لها | organizerCount = 0 |
true |
| مساحات التخزين السحابي المشتركة التي لا تحتوي على رقم تعريف الوحدة التنظيمية | orgUnitId != 'C03az79cb' |
true |
طلب البحث عن عبارات متعددة باستخدام الأقواس
يمكنك استخدام الأقواس لتجميع عبارات طلب بحث متعددة معًا. على سبيل المثال، للبحث عن مساحات التخزين السحابي المشترَكة التي تم إنشاؤها بعد تاريخ معيّن والتي تضم إما أكثر من خمسة منظِّمين أو أكثر من 20 عضوًا، استخدِم طلب البحث التالي:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
يعرض هذا البحث جميع مساحات التخزين السحابي المشتركة التي تم إنشاؤها بعد 1 كانون الثاني (يناير) 2019 والتي تتضمّن أكثر من خمسة منظِّمين أو أكثر من 20 عضوًا.
تقيِّم واجهة برمجة التطبيقات Drive API عاملَي التشغيل and وor من اليمين إلى اليسار،
لذلك سيؤدي البحث نفسه بدون قوسَين إلى عرض ما يلي:
- مساحات التخزين السحابي المشتركة التي تضم أكثر من خمسة منظِّمين والتي تم إنشاؤها بعد 1 كانون الثاني (يناير) 2019 فقط
- جميع مساحات التخزين السحابي المشترَكة التي تضم أكثر من 20 عضوًا، حتى تلك التي تم إنشاؤها قبل 1 كانون الثاني (يناير) 2019