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