يمكنك البحث عن الملفات أو فلترتها باستخدام الطريقتَين
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 للمستخدمين إجراء عمليات بحث على مستوى سلسلة المحادثات، ولكن لا تتيحها واجهة برمجة التطبيقات.