يوفّر هذا الدليل المرجعي عبارات البحث وعوامل التشغيل التي يمكنك استخدامها مع 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 |
تُستخدَم لتحديد ما إذا كانت المجموعة parents تتضمّن المعرّف المحدّد. يتحقّق من المجلدات الرئيسية المباشرة فقط، ولا يتطابق مع المجلدات الرئيسية غير المباشرة. |
owners |
in |
المستخدمون الذين يملكون الملف |
writers |
in |
المستخدمون أو المجموعات الذين لديهم إذن بتعديل الملف يمكنك الاطّلاع على مرجع المورد permissions. |
readers |
in |
المستخدمون أو المجموعات الذين لديهم إذن بقراءة الملف يُرجى الاطّلاع على مرجع المورد permissions. |
sharedWithMe |
=، != |
الملفات الموجودة في مجموعة "تمت مشاركتها معي" الخاصة بالمستخدم جميع مستخدمي الملف مدرَجون في قائمة التحكّم بالوصول (ACL) الخاصة بالملف. يمكن أن تكون القيمة إما true أو false. |
createdTime |
<=، و<، و=، و!=، و>، و>= |
تاريخ إنشاء الملف استخدِم تنسيق RFC 3339، والمنطقة الزمنية التلقائية هي التوقيت العالمي المتفق عليه (UTC)، مثل 2012-06-04T12:00:00-08:00. تتوفّر هذه الميزة في الإصدار 3 من Drive API فقط. |
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، المنطقة الزمنية التلقائية هي التوقيت العالمي المتفق عليه، مثل 2012-06-04T12:00:00-08:00. |
true |
hidden |
=، != |
تحدّد ما إذا كانت مساحة التخزين السحابي المشتركة مخفية. يمكن أن تكون القيمة إما true أو false. |
false |
memberCount |
<=، و<، و=، و!=، و>، و>= |
عدد المستخدمين والمجموعات الأعضاء في مساحة التخزين السحابي المشتركة تأخذ قيمة عددية. | true |
name |
contains، =، != |
اسم مساحة التخزين السحابي المشتركة يجب إحاطة القيمة بعلامات اقتباس مفردة ('). ويمكنك تخطّي علامات الاقتباس المفردة في طلبات البحث باستخدام \'، مثل 'Valentine\'s Day'. |
true |
organizerCount |
<=، و<، و=، و!=، و>، و>= |
عدد المستخدمين والمجموعات الذين يديرون مساحة التخزين السحابي المشتركة تتطلّب قيمة رقمية. | true |
orgUnitId |
=، != |
رقم تعريف الوحدة التنظيمية لمساحة تخزين سحابي مشتركة تأخذ قيمة سلسلة. | true |
لمزيد من الأمثلة على عمليات البحث في سلاسل طلبات البحث، يُرجى الاطّلاع على أمثلة على سلاسل طلبات البحث في مساحات التخزين السحابي المشتركة.