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