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

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

query_term operator values

المكان:

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

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

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

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

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

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

المؤثِّر الاستخدام
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 وGoogle Drive.
modifiedTime <=، <، =، !=، >، >= تاريخ آخر تعديل للملف. تنسيق RFC 3339، تكون المنطقة الزمنية التلقائية هي التوقيت العالمي المنسَّق، مثل 2012-06-04T12:00:00-08:00. لا يمكن مقارنة الحقول من النوع date ببعضها بعضًا، بل بالتواريخ الثابتة فقط.
viewedByMeTime <=، <، =، !=، >، >= تاريخ آخر عرض للمستخدم لملف. تنسيق RFC 3339، تكون المنطقة الزمنية التلقائية هي التوقيت العالمي المنسَّق، مثل 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 <=، <، =، !=، >، >= تاريخ إنشاء مساحة التخزين السحابي المشتركة استخدِم تنسيق 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 في المستند يحتوي على السلسلة "Hello here world"، سيعرض طلب البحث fullText contains '"Hello there"' نتيجة، بينما لا يعرض الاستعلام fullText contains '"Hello world"' نتيجة. وعلاوة على ذلك، بما أنّ البحث أبجدي رقمي، إذا كان النص الكامل للمستند يحتوي على السلسلة "Hello_world"، يعرض طلب البحث fullText contains '"Hello world"' نتيجة.

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

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

عبارات طلبات البحث الخاصة بمساحات التخزين السحابي المشتركة

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

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