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 के यूज़र इंटरफ़ेस (यूआई) की मदद से, उपयोगकर्ता थ्रेड में मौजूद सभी ईमेल खोज सकते हैं. हालांकि, एपीआई की मदद से ऐसा नहीं किया जा सकता.