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

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

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