جستجو برای درایوهای مشترک

این راهنما توضیح می‌دهد که چگونه API گوگل درایو از چندین روش برای جستجوی درایوهای اشتراکی پشتیبانی می‌کند.

برای جستجوی مجموعه‌ای خاص از درایوهای اشتراکی، از فیلد کوئری استرینگ q به همراه متد list روی منبع drives استفاده کنید تا درایوها را با ترکیب یک یا چند عبارت جستجو فیلتر کنید.

یک رشته پرس و جو شامل سه بخش زیر است:

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
عملگر تطبیق رشته ( contains )
درایوهای اشتراکی که در عنوان آنها کلمه «محرمانه» وجود دارد، در میان تمام درایوهای اشتراکی که کاربر عضو آنهاست name contains 'confidential' false
عملگرهای تساوی و نابرابری ( = ، != )
درایوهای اشتراکی در نمای پیش‌فرض قابل مشاهده هستند hidden = false false
درایوهای اشتراکی از نمای پیش‌فرض پنهان شده‌اند hidden = true false
درایوهای اشتراکی بدون هیچ سازمان‌دهنده‌ی اختصاصی organizerCount = 0 true
درایوهای مشترک با دقیقاً یک عضو memberCount = 1 true
درایوهای مشترکی که متعلق به شناسه واحد سازمانی هستند orgUnitId = 'C03az79cb' true
درایوهای اشتراکی که حاوی شناسه واحد سازمانی نیستند orgUnitId != 'C03az79cb' true
درایوهای اشتراکی که نام آنها با یک نام خاص مطابقت ندارد name != 'Archived Projects' true
عملگرهای مقایسه‌ای ( > ، >= ، < ، <= )
درایوهای اشتراکی ایجاد شده پس از ۱ ژوئن ۲۰۱۷ createdTime > '2017-06-01T12:00:00' true
درایوهای اشتراکی ایجاد شده قبل از ۱ ژانویه ۲۰۲۳ createdTime < '2023-01-01T00:00:00' true
درایوهای مشترک با بیش از یک عضو memberCount > 1 true
درایوهای اشتراکی با کمتر از ۵ عضو memberCount < 5 true
درایوهای مشترک با ۳ یا کمتر برگزارکننده organizerCount <= 3 true
عملگرهای منطقی ( and ، or ، not )
درایوهای اشتراکی با کلمه «محرمانه» در عنوان و ۲۰ عضو یا بیشتر name contains 'confidential' and memberCount >= 20 true
درایوهای اشتراکی با عنوان «محرمانه» در بین تمام درایوهای اشتراکی سازمان name contains 'confidential' and orgUnitId = 'C03az79cb' true
درایوهای اشتراکی با نام‌هایی شامل «پروژه» یا «بایگانی» name contains 'Project' or name contains 'Archive' true
درایوهای اشتراکی که در نامشان «Draft» وجود ندارد not name contains 'Draft' true
درایوهای اشتراکی که متعلق به واحد سازمانی هدف نیستند و پس از یک تاریخ خاص ایجاد شده‌اند orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

پرس و جوی چندین عبارت با پرانتز

می‌توانید از پرانتز برای گروه‌بندی چندین عبارت جستجو با هم استفاده کنید. برای مثال، برای جستجوی درایوهای اشتراکی که پس از یک تاریخ خاص ایجاد شده‌اند و بیش از پنج سازمان‌دهنده یا بیش از 20 عضو دارند، از این عبارت جستجو استفاده کنید:

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

این جستجو تمام درایوهای اشتراکی ایجاد شده پس از اول ژانویه ۲۰۱۹ و دارای بیش از پنج سازمان‌دهنده یا بیش از ۲۰ عضو را برمی‌گرداند.

API درایو، عملگرهای and و or را از چپ به راست ارزیابی می‌کند، بنابراین همان جستجو بدون پرانتز نتیجه زیر را خواهد داشت:

  • فقط درایوهایی را با بیش از پنج برگزارکننده که پس از اول ژانویه ۲۰۱۹ ایجاد شده‌اند، به اشتراک بگذارید.
  • همه درایوهای اشتراکی با بیش از ۲۰ عضو، حتی آن‌هایی که قبل از ۱ ژانویه ۲۰۱۹ ایجاد شده‌اند.