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

يوفّر هذا الدليل المرجعي عبارات طلبات البحث وعوامل التشغيل التي يمكنك استخدامها مع 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، وتكون المنطقة الزمنية التلقائية هي التوقيت العالمي المنسق، مثل 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، وتكون المنطقة الزمنية التلقائية هي التوقيت العالمي المنسّق، مثل 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 بشكل غير مباشر في قائمة 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

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