عبارات البحث ومُعامِلات طلب البحث

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

query_term operator values

المكان:

  • query_term عبارة أو حقل طلب البحث للبحث عنه.

  • عامل التشغيل يحدد شرط عبارة طلب البحث.

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

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

عوامل تشغيل طلبات البحث

يسرد هذا الجدول كل عوامل تشغيل طلبات البحث الصالحة:

المؤثِّر الاستخدام
contains محتوى إحدى السلاسل موجود في الأخرى.
= محتوى السلسلة أو القيمة المنطقية يساوي الآخر.
!= محتوى السلسلة أو القيمة المنطقية غير متساوٍ.
< القيمة أقل من قيمة أخرى.
<= القيمة أقل من أو تساوي قيمة أخرى.
> القيمة أكبر من قيمة أخرى.
>= القيمة أكبر من أو تساوي قيمة أخرى.
in يتم تضمين عنصر داخل مجموعة.
and عرض العناصر التي تطابق كلا طلبي البحث.
or عرض العناصر التي تطابق أيًا من طلبي البحث.
not يؤدي إلى إلغاء طلب بحث.
has تحتوي المجموعة على عنصر يطابق المعلمات.

عبارات طلب البحث الخاصة بالملف

يسرد الجدول التالي جميع عبارات طلب البحث الصالحة للملف. للحصول على أنواع البيانات وأوصافها، يُرجى الرجوع إلى مرجع مورد files.

عبارة طلب البحث عوامل التشغيل الصالحة الاستخدام
name contains و= و!= اسم الملف. مُحاط بعلامة اقتباس مفردة '. يمكن إلغاء علامات الاقتباس المفردة في طلبات البحث باستخدام \'، مثل 'Valentine\'s Day'.
fullText contains ما إذا كانت خصائص name أو description أو indexableText أو النص في محتوى الملف أو بياناته الوصفية مطابقة للملف. مُحاط بعلامة اقتباس مفردة '. يمكن إلغاء علامات الاقتباس المفردة في طلبات البحث باستخدام \'، مثل 'Valentine\'s Day'.
mimeType contains و= و!= نوع MIME للملف. مُحاط بعلامة اقتباس مفردة '. يمكن إلغاء علامات الاقتباس المفردة في طلبات البحث باستخدام \'، مثل 'Valentine\'s Day'. للحصول على مزيد من المعلومات عن أنواع MIME، يُرجى الاطِّلاع على أنواع MIME في Google Workspace وDrive.
modifiedTime <=، <، =، !=، >، >= تاريخ آخر تعديل للملف RFC 3339، المنطقة الزمنية التلقائية هي UTC، مثل 2012-06-04T12:00:00-08:00. لا يمكن حاليًا مقارنة الحقول من النوع date ببعضها البعض بل بتواريخ ثابتة فقط.
viewedByMeTime <=، <، =، !=، >، >= تاريخ آخر مرة عرض فيها المستخدم ملفًا. RFC 3339، المنطقة الزمنية التلقائية هي UTC، مثل 2012-06-04T12:00:00-08:00. لا يمكن حاليًا مقارنة الحقول من النوع date ببعضها البعض بل بتواريخ ثابتة فقط.
trashed =، != ما إذا كان الملف في المهملات أم لا. يمكن أن تكون القيمة true أو false.
starred =، != ما إذا كان الملف مميّزًا بنجمة أم لا. يمكن أن تكون القيمة true أو false.
parents in تحدّد هذه السمة ما إذا كانت مجموعة الوالدَين تحتوي على المعرّف المحدّد.
owners in المستخدمون الذين يملكون الملف.
writers in المستخدمون أو المجموعات التي لديها إذن بتعديل الملف. يُرجى الاطِّلاع على مرجع مورد الأذونات.
readers in المستخدمون أو المجموعات التي لديها إذن لقراءة الملف. يُرجى الاطِّلاع على مرجع مورد الأذونات.
sharedWithMe =، != الملفات المتوفّرة في مجموعة "تمت مشاركتها معي" للمستخدم. جميع مستخدمي الملف مدرجون في قائمة التحكم بالوصول (ACL) للملف. يمكن أن تكون القيمة true أو false.
createdTime <=، <، =، !=، >، >= التاريخ الذي تم فيه إنشاء مساحة Drive المشتركة. استخدِم تنسيق RFC 3339، والمنطقة الزمنية التلقائية هي التوقيت العالمي المتّفق عليه، مثل 2012-06-04T12:00:00-08:00.
properties has مواقع الملفات المخصصة العامة.
appProperties has مواقع الملفات المخصصة الخاصة.
visibility =، != مستوى رؤية الملف القيم الصالحة هي anyoneCanFind وanyoneWithLink وdomainCanFind وdomainWithLink وlimited. مُحاط بعلامة اقتباس مفردة '.
shortcutDetails.targetId =، != رقم تعريف العنصر الذي يشير إليه الاختصار.

في ما يلي عرض لتركيبات عبارات عامل التشغيل وعبارات البحث:

  • لا ينفذ عامل التشغيل contains إلا مطابقة البادئة لمصطلح name. على سبيل المثال، نفترض أن لديك اسم HelloWorld. يعرض طلب البحث name contains 'Hello' النتيجة، ولكن لا يعرض طلب البحث name contains 'World' النتيجة.

  • يجري عامل التشغيل contains مطابقة فقط للرموز المميزة للسلسلة بالكامل للعبارة fullText. على سبيل المثال، إذا كان النص الكامل لأحد المستندات يحتوي على السلسلة "HelloWorld"، لن يعرض أي من طلبات البحث fullText contains 'HelloWorld' سوى نتيجة.

  • يطابق عامل التشغيل contains عبارة أبجدية رقمية تمامًا إذا كانت محاطة بعلامات اقتباس مزدوجة. على سبيل المثال، إذا كان fullText لمستند يحتوي على السلسلة "مرحبًا هناك"، فإن طلب البحث fullText contains '"Hello there"' يعرض نتيجة، بينما لا يحتوي طلب البحث fullText contains '"Hello world"' على أي نتيجة. علاوة على ذلك، نظرًا لأن عملية البحث تحتوي على أحرف أبجدية رقمية، إذا كان النص الكامل للمستند يحتوي على السلسلة "Hello_world"، فإن طلب البحث fullText contains '"Hello world"' يعرض نتيجة.

  • تظهر المصطلحات owners وwriters وreaders بشكل غير مباشر في قائمة الأذونات وتشير إلى role في الإذن.

للحصول على المزيد من الأمثلة على عمليات البحث في سلسلة طلب البحث، راجع أمثلة سلسلة طلب البحث.

عبارات طلب البحث المُحدَّدة لمساحة Drive المشتركة

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

عبارة طلب البحث عوامل التشغيل الصالحة الاستخدام إعداد useDomainAdminAccess المطلوب
createdTime <=، <، =، !=، >، >= التاريخ الذي تم فيه إنشاء مساحة Drive المشتركة. RFC 3339، المنطقة الزمنية التلقائية هي UTC، مثل 2012-06-04T12:00:00-08:00. true
hidden =، != يُحدِّد ما إذا كانت مساحة التخزين السحابي المشتركة مخفية أم لا. يمكن أن تكون القيمة true أو false. false
memberCount <=، <، =، !=، >، >= عدد المستخدمين والمجموعات الأعضاء في مساحة التخزين السحابي المشتركة. يتخذ قيمة رقمية. true
name contains و= و!= اسم مساحة Drive المشتركة. مُحاط بعلامة اقتباس مفردة '. يمكن إلغاء علامات الاقتباس المفردة في طلبات البحث باستخدام \'، مثل 'Valentine\'s Day'. false
organizerCount <=، <، =، !=، >، >= عدد المستخدمين والمجموعات المنظِّمين في مساحة التخزين السحابي المشتركة. يتخذ قيمة رقمية. true
orgUnitId =، != رقم تعريف الوحدة التنظيمية (OU) لمساحة Drive المشتركة. يأخذ قيمة سلسلة. true