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