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

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

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