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

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

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