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

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

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