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

این راهنمای مرجع، اصطلاحات و عملگرهایی را ارائه می‌کند که می‌توانید با Google Drive API برای فیلتر کردن فایل‌ها، پوشه‌ها و درایوهای مشترک استفاده کنید.

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

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

نحو رشته پرس و جو

یک query string شامل سه بخش زیر است:

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"' یک نتیجه است، اما query fullText contains '"Hello world"' نیست. علاوه بر این، از آنجایی که جستجو حروف عددی است، اگر متن کامل یک سند حاوی رشته "Hello_world" باشد، عبارت fullText contains '"Hello world"' نتیجه ای را برمی گرداند.

  • اصطلاحات owners ، writers و readers به طور غیرمستقیم در لیست permissions منعکس می شوند و به role در مجوز اشاره می کنند. برای فهرست کامل مجوزهای نقش، به نقش‌ها و مجوزها مراجعه کنید.

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

شرایط پرس و جو مخصوص درایو مشترک

جدول زیر تمام عبارات پرس و جو درایو مشترک معتبر را فهرست می کند. برای انواع داده ها و توضیحات، به مرجع منبع drives مراجعه کنید.

اصطلاح پرس و جو اپراتورهای معتبر استفاده useDomainAdminAccess تنظیمات DomainAdminAccess
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

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