تحتوي سلسلة طلب البحث على الأجزاء الثلاثة التالية:
query_term operator values
المكان:
query_term عبارة أو حقل طلب البحث للبحث عنه.
عامل التشغيل يحدد شرط عبارة طلب البحث.
القيم هي القيم المحددة التي تريد استخدامها لتصفية نتائج البحث.
يوفر هذا المرجع عبارات البحث وعوامل التشغيل التي يمكنك استخدامها مع واجهة برمجة تطبيقات Google Drive.
عوامل تشغيل طلبات البحث
يسرد هذا الجدول كل عوامل تشغيل طلبات البحث الصالحة:
| المؤثِّر | الاستخدام |
|---|---|
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 و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 |
<=، <، =، !=، >، >= |
التاريخ الذي تم فيه إنشاء مساحة Drive المشتركة. استخدِم تنسيق 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لمستند يحتوي على السلسلة "مرحبًا هناك"، فإن طلب البحثfullText contains '"Hello there"'يعرض نتيجة، بينما لا يحتوي طلب البحثfullText contains '"Hello world"'على أي نتيجة. علاوة على ذلك، نظرًا لأن عملية البحث تحتوي على أحرف أبجدية رقمية، إذا كان النص الكامل للمستند يحتوي على السلسلة "Hello_world"، فإن طلب البحثfullText contains '"Hello world"'يعرض نتيجة.تظهر المصطلحات
ownersوwritersوreadersبشكل غير مباشر في قائمة الأذونات وتشير إلىroleفي الإذن.
للحصول على المزيد من الأمثلة على عمليات البحث في سلسلة طلب البحث، راجع أمثلة سلسلة طلب البحث.
عبارات طلب البحث المُحدَّدة لمساحة Drive المشتركة
يعرض الجدول التالي جميع عبارات طلب البحث لمساحة التخزين السحابي المشتركة الصالحة. لمعرفة أنواع البيانات وأوصافها، يُرجى الاطِّلاع على مرجع مورد drives.
| عبارة طلب البحث | عوامل التشغيل الصالحة | الاستخدام | إعداد useDomainAdminAccess المطلوب |
|---|---|---|---|
createdTime |
<=، <، =، !=، >، >= |
التاريخ الذي تم فيه إنشاء مساحة Drive المشتركة. RFC 3339، المنطقة الزمنية التلقائية هي UTC، مثل 2012-06-04T12:00:00-08:00. |
true |
hidden |
=، != |
يُحدِّد ما إذا كانت مساحة التخزين السحابي المشتركة مخفية أم لا. يمكن أن تكون القيمة true أو false. |
false |
memberCount |
<=، <، =، !=، >، >= |
عدد المستخدمين والمجموعات الأعضاء في مساحة التخزين السحابي المشتركة. يتخذ قيمة رقمية. | true |
name |
contains و= و!= |
اسم مساحة Drive المشتركة. مُحاط بعلامة اقتباس مفردة '. يمكن إلغاء علامات الاقتباس المفردة في طلبات البحث باستخدام \'، مثل 'Valentine\'s Day'. |
false |
organizerCount |
<=، <، =، !=، >، >= |
عدد المستخدمين والمجموعات المنظِّمين في مساحة التخزين السحابي المشتركة. يتخذ قيمة رقمية. | true |
orgUnitId |
=، != |
رقم تعريف الوحدة التنظيمية (OU) لمساحة Drive المشتركة. يأخذ قيمة سلسلة. | true |