البحث عن مساحات Drive المشتركة

يوضّح هذا الدليل كيف تتيح Google Drive API عدة طرق للبحث في مساحات التخزين السحابي المشتركة.

للبحث عن مجموعة معيّنة من مساحات التخزين السحابي المشتركة، استخدِم حقل سلسلة طلب البحث q مع طريقة list في مصدر drives لفلترة مساحات التخزين السحابي التي سيتم عرضها من خلال الجمع بين عبارة بحث واحدة أو أكثر.

تحتوي سلسلة طلب البحث على ثلاثة أجزاء:

query_term operator values

المكان:

  • query_term هي عبارة البحث أو الحقل الذي يتم البحث فيه.

  • operator تحدّد الشرط لعبارة البحث.

  • values هي القيم المحدّدة التي تريد استخدامها لفلترة نتائج البحث.

على سبيل المثال، تعمل سلسلة طلب البحث التالية على فلترة البحث لعرض مساحات التخزين السحابي التي تحمل الاسم "Google Drive API resources" فقط.

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

للاطّلاع على جميع عبارات البحث في مساحات التخزين السحابي المشتركة، يُرجى الاطّلاع على عبارات البحث الخاصة بمساحات التخزين السحابي المشتركة.

للاطّلاع على جميع عوامل تشغيل البحث التي يمكنك استخدامها لإنشاء طلب بحث، يُرجى الاطّلاع على عوامل تشغيل البحث.

أمثلة على سلاسل طلب البحث

يعرض الجدول التالي أمثلة على بعض سلاسل طلب البحث الأساسية لمساحات التخزين السحابي المشتركة. يختلف الرمز الفعلي حسب مكتبة العميل التي تستخدمها في بحثك.

عليك أيضًا إزالة الأحرف الخاصة في أسماء الملفات للتأكّد من أنّ طلب البحث يعمل بشكلٍ صحيح. على سبيل المثال، إذا كان اسم الملف يحتوي على كل من الفاصلة العليا (') والشرطة المائلة للخلف ("\")، استخدِم شرطة مائلة للخلف لإزالتها: name contains 'quinn\'s paper\\essay'.

ما الذي تريد البحث عنه؟ مثال إعداد useDomainAdminAccess
عامل تشغيل مطابقة السلسلة (contains)
مساحات التخزين السحابي المشتركة التي تحتوي على الكلمة "confidential" في العنوان من بين جميع مساحات التخزين السحابي المشتركة التي يكون المستخدم عضوًا فيها name contains 'confidential' false
عوامل تشغيل المساواة وعدم المساواة (=، !=)
مساحات التخزين السحابي المشتركة الظاهرة في العرض التلقائي hidden = false false
مساحات التخزين السحابي المشتركة المخفية عن العرض التلقائي hidden = true false
مساحات التخزين السحابي المشتركة التي ليس لها منظّم معيّن organizerCount = 0 true
مساحات التخزين السحابي المشتركة التي تضم عضوًا واحدًا فقط memberCount = 1 true
مساحات التخزين السحابي المشتركة التي تنتمي إلى رقم تعريف الوحدة التنظيمية orgUnitId = 'C03az79cb' true
مساحات التخزين السحابي المشتركة التي لا تحتوي على رقم تعريف الوحدة التنظيمية orgUnitId != 'C03az79cb' true
مساحات التخزين السحابي المشتركة التي لا تتطابق أسماؤها مع اسم معيّن name != 'Archived Projects' true
عوامل تشغيل المقارنة (>، >=، <، <=)
مساحات التخزين السحابي المشتركة التي تم إنشاؤها بعد 1 يونيو 2017 createdTime > '2017-06-01T12:00:00' true
مساحات التخزين السحابي المشتركة التي تم إنشاؤها قبل 1 يناير 2023 createdTime < '2023-01-01T00:00:00' true
مساحات التخزين السحابي المشتركة التي تضم أكثر من عضو واحد memberCount > 1 true
مساحات التخزين السحابي المشتركة التي تضم أقل من 5 أعضاء memberCount < 5 true
مساحات التخزين السحابي المشتركة التي تضم 3 منظِّمين أو أقل organizerCount <= 3 true
عوامل التشغيل المنطقية (and, or, not)
مساحات التخزين السحابي المشتركة التي تحتوي على الكلمة "confidential" في العنوان وتضم 20 عضوًا أو أكثر name contains 'confidential' and memberCount >= 20 true
مساحات التخزين السحابي المشتركة التي تحتوي على الكلمة "confidential" في العنوان من بين جميع مساحات التخزين السحابي المشتركة في المؤسسة name contains 'confidential' and orgUnitId = 'C03az79cb' true
مساحات التخزين السحابي المشتركة التي تحتوي أسماؤها على "Project" أو "Archive" name contains 'Project' or name contains 'Archive' true
مساحات التخزين السحابي المشتركة التي لا تحتوي أسماؤها على "Draft" not name contains 'Draft' true
مساحات التخزين السحابي المشتركة التي لا تنتمي إلى وحدة تنظيمية مستهدَفة وتم إنشاؤها بعد تاريخ معيّن orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' 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