इस दस्तावेज़ में, Gmail API के
messages.list
तरीके को कॉल करने का तरीका बताया गया है.
यह तरीका, Gmail के messages ऑब्जेक्ट का कलेक्शन दिखाता है. इसमें मैसेज का id और threadId शामिल होता है. मैसेज की पूरी जानकारी पाने के लिए, messages.get
तरीके का इस्तेमाल करें.
ज़रूरी शर्तें
Python
आपके पास Gmail API की सुविधा वाला Google Cloud प्रोजेक्ट होना चाहिए. इसके लिए, Gmail API Python क्विकस्टार्ट गाइड पूरी करें.
मैसेज की सूची देखना
messages.list तरीका, मैसेज फ़िल्टर करने के लिए कई क्वेरी पैरामीटर इस्तेमाल करता है:
maxResults: लौटाए जाने वाले मैसेज की ज़्यादा से ज़्यादा संख्या. इसकी डिफ़ॉल्ट वैल्यू 100 और ज़्यादा से ज़्यादा वैल्यू 500 होती है.pageToken: नतीजों का कोई खास पेज पाने के लिए टोकन.q: मैसेज फ़िल्टर करने के लिए क्वेरी स्ट्रिंग. जैसे,from:someuser@example.com is:unread.labelIds: सिर्फ़ उन मैसेज को लौटाएं जिनमें ऐसे लेबल हों जो बताए गए सभी लेबल आईडी से मेल खाते हों.includeSpamTrash: नतीजों मेंSPAMऔरTRASHफ़ोल्डर के मैसेज शामिल करें.
कोड सैंपल
Python
यहां दिए गए कोड सैंपल में, पुष्टि किए गए Gmail उपयोगकर्ता के लिए मैसेज की सूची देखने का तरीका बताया गया है. क्वेरी से मेल खाने वाले सभी मैसेज पाने के लिए, कोड में पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा का इस्तेमाल किया जाता है.
messages.list तरीका, रिस्पॉन्स का मुख्य हिस्सा दिखाता है. इसमें ये चीज़ें शामिल होती हैं:
messages[]:Messageरिसॉर्स का कलेक्शन.nextPageToken: ऐसे अनुरोधों के लिए जिनमें नतीजों के कई पेज होते हैं, एक टोकन. इसका इस्तेमाल, ज़्यादा मैसेज की सूची देखने के लिए बाद में किए जाने वाले कॉल के साथ किया जा सकता है.resultSizeEstimate: नतीजों की अनुमानित कुल संख्या.
मैसेज का पूरा कॉन्टेंट और मेटाडेटा पाने के लिए, message.id फ़ील्ड का इस्तेमाल करें
messages.get
तरीके को कॉल करने के लिए.