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