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

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

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