برای جستجوی مجموعه خاصی از درایوهای مشترک، از فیلد query string q با drives.list استفاده کنید تا با ترکیب یک یا چند عبارت جستجو، درایوها را فیلتر کنید.
یک query string شامل سه بخش زیر است:
query_term operator values
کجا:
query_termعبارت یا فیلدی است که باید در آن جستجو کرد.operatorشرط را برای عبارت پرس و جو مشخص می کند.valuesمقادیر خاصی هستند که می خواهید برای فیلتر کردن نتایج جستجوی خود استفاده کنید.
برای مشاهده عبارت‌های جستجو و عملگرهایی که می‌توانید برای فیلتر کردن درایوهای مشترک استفاده کنید، به عبارت‌ها و عملگرهای درخواست جستجو مراجعه کنید.
به عنوان مثال، رشته جستجوی زیر جستجو را فیلتر می کند تا فقط درایوهای مشترک با نام «منابع API Google Drive» را برگرداند.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
نمونه های رشته پرس و جو
جدول زیر نمونه هایی از رشته های پرس و جوی اولیه را برای درایوهای مشترک فهرست می کند. کد واقعی بسته به کتابخانه مشتری که برای جستجوی خود استفاده می کنید متفاوت است.
همچنین باید از کاراکترهای خاص در نام فایل خود فرار کنید تا مطمئن شوید که پرس و جو به درستی کار می کند. به عنوان مثال، اگر نام فایلی دارای هر دو کاراکتر آپاستروف ( ' ) و بک اسلش ( "\" ) باشد، برای فرار از آنها از بک اسلش استفاده کنید: name contains 'quinn\'s paper\\essay' .
| چیزی که می خواهید پرس و جو کنید | مثال | useDomainAdminAccess تنظیمات DomainAdminAccess |
|---|---|---|
| درایوهای مشترک ایجاد شده پس از ۱ ژوئن ۲۰۱۷ | 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 |
چند عبارت را با پرانتز جستجو کنید
می توانید از پرانتز برای گروه بندی چند عبارت پرس و جو با هم استفاده کنید. به عنوان مثال، برای جستجوی درایوهای مشترک ایجاد شده پس از یک تاریخ خاص و دارای بیش از پنج سازمان دهنده یا بیش از 20 عضو، از این عبارت استفاده کنید:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
این جستجو همه درایوهای مشترک ایجاد شده پس از 1 ژانویه 2019 و دارای بیش از پنج سازمان دهنده یا بیش از 20 عضو را برمی گرداند.
Drive API and or عملگرها را از چپ به راست ارزیابی می‌کند، بنابراین همان جستجوی بدون پرانتز برمی‌گردد:
- فقط درایوهای مشترک با بیش از پنج سازمان‌دهنده که پس از ۱ ژانویه ۲۰۱۹ ایجاد شده‌اند.
- همه درایوهای مشترک با بیش از 20 عضو، حتی آنهایی که قبل از 1 ژانویه 2019 ایجاد شده اند.