يمكنك البحث في الملفات أو فلترتها باستخدام الطريقتَين
messages.list و
threads.list.
تقبل هذه الطرق المَعلمة q التي تتيح استخدام معظم بنية البحث المتقدّم نفسها المُستخدَمة في واجهة ويب Gmail. للحصول على قائمة بالاختلافات بين البحث والفلترة في
واجهة مستخدم Gmail وGmail API، يُرجى الاطّلاع على
الاختلافات بين فلترة البحث: واجهة مستخدم Gmail في مقابل Gmail API.
تسمح لك هذه البنية المتقدمة باستخدام طلبات البحث لفلترة الرسائل حسب سمات مثل المُرسِل أو التاريخ أو التصنيف، على سبيل المثال. على سبيل المثال، يسترجع طلب البحث التالي جميع الرسائل التي أرسلها المستخدم في كانون الثاني (يناير) 2014:
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.
الاختلافات بين البحث والفلترة: واجهة مستخدم Gmail مقابل Gmail API
تُجري واجهة مستخدم Gmail عملية توسيع الاسم المعرِّف، ما يسمح لها باستنتاج اسم معرِّف حساب من حساب Google Workspace. على سبيل المثال، لنفترض أنّ لديك حسابًا بعنوان
myprimary@mycompany.netوأنّ المشرف يضبط عنوانًا بديلاً لذلك الحساب هوmyalias@mycompany.net. إذا أرسلmyalias@mycompany.netرسالة إلكترونية، ولكنك بحثت عن "from: myprimary@mycompany.net)"، ستظهر الرسالة الإلكترونية المُرسَلة منmyalias@mycompany.netكنتيجة بحث في واجهة مستخدم Gmail، ولكن ليس في استجابة واجهة برمجة التطبيقات.تسمح واجهة مستخدم Gmail للمستخدمين بإجراء عمليات بحث على مستوى السلسلة، ولكن واجهة برمجة التطبيقات لا تسمح بذلك.