عبارات و اپراتورهای پرس و جو را جستجو کنید

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

برای مثال‌های بیشتر از جستجوهای رشته پرس‌وجو، به مثال‌های رشته پرس‌وجوی درایو مشترک مراجعه کنید.