این راهنمای مرجع اصطلاحات پُرسمان و عملگرهایی را که می‌توانید با 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، =، != |
نوع رسانه فایل. با نقل‌قول تکی (') احاطه کنید. نقل‌قول‌های تکی را در پُرسمان‌ها با \' گریز دهید، مثلاً '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 |
آیا مجموعه parents حاوی شناسه مشخص‌شده است یا نه. فقط پوشه‌های مادر مستقیم را بررسی می‌کند؛ با پوشه‌های جد غیرمستقیم مطابقت ندارد. |
owners |
in |
کاربرانی که مالک فایل هستند. |
writers |
in |
کاربران یا گروه‌هایی که اجازه اصلاح فایل را دارند. مرجع منبع permissions را ببینید. |
readers |
in |
کاربران یا گروه‌هایی که اجازه خواندن فایل را دارند. مرجع منبع permissions را ببینید. |
sharedWithMe |
=، != |
فایل‌هایی که در مجموعه «هم‌رسانی‌شده با من» کاربر قرار دارند. همه کاربران فایل در «فهرست کنترل دسترسی» (ACL) فایل قرار دارند. می‌تواند true یا false باشد. |
createdTime |
<=، <، =، !=، >، >= |
تاریخی که فایل ایجاد شده است. از قالب RFC 3339 استفاده کنید، منطقه زمانی پیش‌فرض UTC است، مثل 2012-06-04T12:00:00-08:00. فقط در Drive API v3 پشتیبانی می‌شود. |
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 |
برای نمونه‌های بیشتر از جستجوهای رشته پُرسمان، نمونه‌های رشته پُرسمان درایو مشترک را ببینید.