شما میتوانید با استفاده از متدهای messages.list و threads.list فایلها را جستجو یا فیلتر کنید. این متدها پارامتر q را میپذیرند که از اکثر سینتکسهای جستجوی پیشرفته مشابه رابط وب Gmail پشتیبانی میکند. برای مشاهدهی فهرستی از تفاوتهای جستجو و فیلتر بین رابط کاربری Gmail و رابط برنامهنویسی کاربردی Gmail، به تفاوتهای فیلتر جستجو: رابط کاربری Gmail در مقابل رابط برنامهنویسی کاربردی Gmail مراجعه کنید.
این سینتکس پیشرفته به شما امکان میدهد از کوئریهای جستجو برای فیلتر کردن پیامها بر اساس ویژگیهایی مانند فرستنده، تاریخ یا برچسب و موارد دیگر استفاده کنید. برای مثال، کوئری زیر تمام پیامهای ارسال شده توسط کاربر در ژانویه ۲۰۱۴ را بازیابی میکند:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
علاوه بر جستجوی کوئریها، میتوانید پیامها و رشتهها را بر اساس برچسب با پارامتر labelIds نیز فیلتر کنید. این به شما امکان میدهد پیامها و رشتههایی را با برچسبهای سیستم یا کاربر مشخص شده جستجو کنید. برای اطلاعات بیشتر، به مرجع متد messages.list یا threads.list مراجعه کنید.
تفاوتهای جستجو و فیلتر: رابط کاربری جیمیل در مقابل رابط برنامهنویسی کاربردی جیمیل
رابط کاربری جیمیل، بسط نام مستعار را انجام میدهد که به آن اجازه میدهد نام مستعار یک حساب را از یک حساب Google Workspace استنباط کند. برای مثال، فرض کنید شما یک حساب کاربری
myprimary@mycompany.netدارید و مدیر شما یک نام مستعار برای آن حساب کاربریmyalias@mycompany.netتنظیم میکند. اگرmyalias@mycompany.netایمیلی ارسال کند، اما شما عبارت "from: myprimary@mycompany.net)" را جستجو کنید، ایمیل ارسال شده توسطmyalias@mycompany.netبه عنوان نتیجه جستجو در رابط کاربری جیمیل نمایش داده میشود، اما در پاسخ API نمایش داده نمیشود.رابط کاربری جیمیل به کاربران اجازه میدهد جستجوهایی در سطح کل رشته انجام دهند، اما API این امکان را ندارد.