يوفّر هذا الدليل المرجعي عبارات طلبات البحث وعوامل التشغيل التي يمكنك استخدامها مع 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 |
لمزيد من الأمثلة حول عمليات البحث في سلسلة طلب البحث، يُرجى الاطّلاع على أمثلة على سلسلة طلب البحث لمساحة التخزين السحابي المشتركة.
مواضيع ذات صلة
- البحث عن الملفات والمجلدات
- البحث عن مساحات التخزين السحابي المشتركة
- أنواع MIME المتوافقة مع Google Workspace وGoogle Drive
- الأدوار والأذونات