تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
للبحث عن مجموعة معيّنة من مساحات التخزين السحابي المشتركة، استخدِم الحقل q في سلسلة طلب البحث
مع drives.list لفلترة مساحات التخزين السحابي
التي سيتم عرضها من خلال دمج عبارة بحث واحدة أو أكثر.
تحتوي سلسلة طلب البحث على الأجزاء الثلاثة التالية:
query_term operator values
المكان:
query_term هي عبارة البحث أو الحقل الذي سيتم البحث فيه.
تحدّد operator شرط عبارة البحث.
values هي القيم المحدّدة التي تريد استخدامها لفلترة نتائج البحث.
للاطّلاع على عبارات البحث وعوامل التشغيل التي يمكنك استخدامها لفلترة مساحات التخزين السحابي المشتركة، راجِع عبارات البحث وعوامل التشغيل.
على سبيل المثال، يفلتر سلسلة طلب البحث التالية نتائج البحث لعرض مساحات Drive المشتركة التي تحمل الاسم "مراجع Google Drive API" فقط.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
أمثلة على سلاسل طلبات البحث
يعرض الجدول التالي أمثلة على بعض سلاسل طلبات البحث الأساسية الخاصة بالمساحات المشتركة. يختلف الرمز الفعلي حسب مكتبة البرامج التي تستخدمها في البحث.
يجب أيضًا إلغاء الأحرف الخاصة في أسماء الملفات للتأكّد من أنّ طلب البحث يعمل بشكل صحيح. على سبيل المثال، إذا كان اسم الملف يحتوي على كل من علامة اقتباس مفردة (') وعلامة شرطة مائلة عكسية ("\")، استخدِم علامة شرطة مائلة عكسية لتجنُّبها: name
contains 'quinn\'s paper\\essay'.
ما تريد البحث عنه
مثال
الإعداد useDomainAdminAccess
مساحات التخزين السحابي المشتركة التي تم إنشاؤها بعد 1 يونيو 2017
createdTime > '2017-06-01T12:00:00'
true
مساحات التخزين السحابي المشتركة المرئية في العرض التلقائي
hidden = false
false
مساحات التخزين السحابي المشتركة التي تضمّ أكثر من عضو واحد
memberCount > 1
true
مساحات التخزين السحابي المشتركة التي تتضمّن كلمة "سري" في العنوان و20 عضوًا أو أكثر
name contains 'confidential' and memberCount >= 20
true
مساحات التخزين السحابي المشتركة التي تتضمّن كلمة "سري" في العنوان بين جميع مساحات التخزين السحابي المشتركة في المؤسسة
name contains 'confidential' and orgUnitId = 'C03az79cb'
true
مساحات التخزين السحابي المشتركة التي تتضمّن الكلمة "سري" في العنوان بين جميع مساحات التخزين السحابي المشتركة التي يكون المستخدم عضوًا فيها
name contains 'confidential'
false
مساحات التخزين السحابي المشتركة التي لم يتم تعيين منظِّم لها
organizerCount = 0
true
مساحات التخزين السحابي المشتركة التي لا تحتوي على رقم تعريف الوحدة التنظيمية
orgUnitId != 'C03az79cb'
true
البحث عن عبارات متعددة باستخدام الأقواس
يمكنك استخدام الأقواس لتجميع عبارات بحث متعددة معًا. على سبيل المثال، للبحث عن مساحات Drive مشتركة تم إنشاؤها بعد تاريخ معيّن وتضمّ أكثر من خمسة منظِّمين أو أكثر من 20 عضوًا، استخدِم طلب البحث التالي:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
يعرض هذا البحث جميع مساحات التخزين السحابي المشتركة التي تم إنشاؤها بعد 1 كانون الثاني (يناير) 2019 والتي تضم أكثر من خمسة منظِّمين أو أكثر من 20 عضوًا.
تقيِّم واجهة برمجة التطبيقات Drive API عاملَي التشغيل and وor من اليمين إلى اليسار،
لذا سيؤدي البحث نفسه بدون أقواس إلى عرض النتائج التالية:
مساحات التخزين السحابي المشتركة التي تضم أكثر من خمسة منظِّمين وتم إنشاؤها بعد 1 كانون الثاني (يناير) 2019
جميع مساحات التخزين السحابي المشتركة التي تضم أكثر من 20 عضوًا، حتى تلك التي تم إنشاؤها قبل 1 كانون الثاني (يناير) 2019
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Search for shared drives\n\nTo search for a specific set of shared drives, use the query string `q` field\nwith [`drives.list`](/workspace/drive/api/reference/rest/v3/drives/list) to filter the drives to\nreturn by combining one or more search terms.\n\nA query string contains the following three parts:\n\n*`query_term operator values`*\n\nWhere:\n\n- *`query_term`* is the query term or field to search upon.\n\n | **Note:** Most query terms require `useDomainAdminAccess=true`. For more information about this flag, see [`drives.list`](/workspace/drive/api/reference/rest/v3/drives/list).\n- *`operator`* specifies the condition for the query term.\n\n- *`values`* are the specific values you want to use to filter your search\n results.\n\nTo view the query terms and operators that you can use to filter shared drives,\nsee [Search query terms and operators](/workspace/drive/api/guides/ref-search-terms#drive-properties).\n\nFor example, the following query string filters the search to only return shared\ndrives with the name \"Google Drive API resources.\" \n\n q: name = 'Google Drive API resources' & useDomainAdminAccess=false\n\nQuery string examples\n---------------------\n\nThe following table lists examples of some basic query strings for shared\ndrives. The actual code differs depending on the client library you use for your\nsearch.\n\nYou must also escape special characters in your file names to make sure the\nquery works correctly. For example, if a filename contains both an apostrophe\n(`'`) and a backslash (`\"\\\"`) character, use a backslash to escape them: `name\ncontains 'quinn\\'s paper\\\\essay'`.\n| **Note:** These examples show the unencoded `q` parameter, where `organizerCount =\n| 0` is encoded as `organizerCount+%3d+0`. Client libraries handle this encoding automatically.\n\n| What you want to query | Example | `useDomainAdminAccess` setting |\n|--------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|--------------------------------|\n| Shared drives created after June 1, 2017 | `createdTime \u003e '2017-06-01T12:00:00'` | `true` |\n| Shared drives visible in the default view | `hidden = false` | `false` |\n| Shared drives with more than one member | `memberCount \u003e 1` | `true` |\n| Shared drives with the word 'confidential' in the title and 20 or more members | `name contains 'confidential' and memberCount \u003e= 20` | `true` |\n| Shared drives with the word 'confidential' in the title among all shared drives of the organization | `name contains 'confidential' and orgUnitId = 'C03az79cb'` | `true` |\n| Shared drives with the word 'confidential' in the title among all shared drives that the user is a member of | `name contains 'confidential'` | `false` |\n| Shared drives with no assigned organizer | `organizerCount = 0` | `true` |\n| Shared drives that don't contain the organizational unit ID | `orgUnitId != 'C03az79cb'` | `true` |\n\nQuery multiple terms with parentheses\n-------------------------------------\n\nYou can use parentheses to group multiple query terms together. For example, to\nsearch for shared drives created after a specific date and that either have more\nthan five organizers or more than 20 members, use this query: \n\n createdTime \u003e '2019-01-01T12:00:00' and (organizerCount \u003e 5 or\n memberCount \u003e 20)\n\nThis search returns all shared drives created after January 1st, 2019 and that\nhave more than five organizers or more than 20 members.\n\nThe Drive API evaluates `and` and `or` operators from left to right,\nso the same search without parentheses would return:\n\n- Only shared drives with more than five organizers that were created after January 1st, 2019.\n- All shared drives with more than 20 members, even those created before January 1st, 2019.\n\nRelated topics\n--------------\n\n- [Search for files and folders](/workspace/drive/api/guides/search-files)\n- [Search query terms and operators](/workspace/drive/api/guides/ref-search-terms)"]]
