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

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

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

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

بنية سلسلة طلب البحث

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

query_term operator values

المكان:

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

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

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

عوامل تشغيل الاستعلام

يسرد الجدول التالي عوامل تشغيل الاستعلام الصالحة:

مُشغِّل الاستخدام
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، وتكون المنطقة الزمنية التلقائية هي التوقيت العالمي المنسَّق (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 المستخدمون أو المجموعات التي لديها إذن بتعديل الملف. اطّلِع على مرجع مرجع permissions.
readers in المستخدمون أو المجموعات التي لديها الإذن لقراءة الملف اطّلِع على مرجع مرجع permissions.
sharedWithMe =، != الملفات المدرَجة في مجموعة "تمت مشاركتها معي" الخاصة بالمستخدم جميع مستخدمي الملف مدرجون في قائمة التحكم بالوصول (ACL) للملف. يمكن أن يكون إما true أو false.
createdTime <=، <، =، !=، >، >= تاريخ إنشاء مساحة التخزين السحابي المشتركة استخدِم التنسيق RFC 3339، وتكون المنطقة الزمنية التلقائية هي التوقيت العالمي المنسَّق (UTC)، مثل 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 there world"، يعني ذلك أنّ طلب البحث fullText contains '"Hello there"' يعرض نتيجة، بينما لا يعرض طلب البحث fullText contains '"Hello world"' ذلك. علاوة على ذلك، بما أنّ البحث أبجدي رقمي، إذا كان النص الكامل للمستند يحتوي على السلسلة "Hello_world"، يعرض طلب البحث fullText contains '"Hello world"' نتيجة.

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

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

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

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

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

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