Gmail API का इस्तेमाल करके ईमेल भेजने के दो तरीके हैं:
messages.send
तरीके का इस्तेमाल करके, इसे सीधे भेजा जा सकता है.- इसे ड्राफ़्ट से भेजा जा सकता है. इसके लिए,
drafts.send
तरीके का इस्तेमाल करें.
ईमेल, मैसेज के रिसॉर्स की raw
प्रॉपर्टी में, base64url कोड में बदली गई स्ट्रिंग के तौर पर भेजे जाते हैं. ईमेल भेजने का उच्च-स्तरीय
वर्कफ़्लो यह है:
- आसानी से ईमेल का कॉन्टेंट बनाएं और उसे base64url स्ट्रिंग के तौर पर एन्कोड करें.
- नया मैसेज संसाधन बनाएं और इसकी
raw
प्रॉपर्टी को, अभी-अभी बनाई गई base64url स्ट्रिंग पर सेट करें. messages.send
पर कॉल करें या अगर ड्राफ़्ट भेज रहे हैं, तो मैसेज भेजने के लिएdrafts.send
पर कॉल करें.
क्लाइंट लाइब्रेरी और प्रोग्रामिंग भाषा की आपकी पसंद के आधार पर, इस वर्कफ़्लो की जानकारी अलग-अलग हो सकती है.
मैसेज बनाना
Gmail API के लिए ज़रूरी है कि MIME ईमेल मैसेज आरएफ़सी 2822 के मुताबिक हों और उसे base64url स्ट्रिंग के तौर पर एन्कोड किया गया हो. कई प्रोग्रामिंग भाषाओं में ऐसी लाइब्रेरी या सुविधाएं होती हैं जो MIME मैसेज बनाने और उन्हें कोड में बदलने की प्रोसेस को आसान बनाती हैं. नीचे दिए गए कोड के उदाहरणों में बताया गया है कि अलग-अलग भाषाओं के लिए, Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके MIME मैसेज कैसे बनाया जाए.
Java
javax.mail.internet
पैकेज में मौजूद MimeMessage
क्लास की मदद से, ईमेल मैसेज बनाना काफ़ी आसान बनाया जा सकता है. इस उदाहरण में हेडर के साथ-साथ
ईमेल मैसेज बनाने का तरीका बताया गया है:
अगले चरण में, MimeMessage
को कोड में बदलना, Message
ऑब्जेक्ट को इंस्टैंशिएट करना, और base64url कोड में बदली गई मैसेज स्ट्रिंग को raw
प्रॉपर्टी की वैल्यू के तौर पर सेट करना है.
Python
नीचे दिए गए कोड सैंपल में MIME मैसेज बनाने, base64url स्ट्रिंग को कोड में बदलने, और उसे Message
संसाधन के raw
फ़ील्ड को असाइन करने के बारे में बताया गया है:
अटैचमेंट के साथ मैसेज बनाना
किसी अटैचमेंट के साथ मैसेज बनाना, कोई दूसरा मैसेज बनाने जैसा होता है. हालांकि, फ़ाइल को कई हिस्सों वाले MIME मैसेज के तौर पर अपलोड करने की प्रोसेस, प्रोग्रामिंग भाषा पर निर्भर करती है. नीचे दिए गए कोड के उदाहरणों में, अटैचमेंट के साथ कई हिस्सों वाले MIME मैसेज बनाने के संभावित तरीके बताए गए हैं.
Java
इस उदाहरण में कई हिस्सों वाला MIME मैसेज बनाने का तरीका बताया गया है. कोड में बदलने और असाइनमेंट असाइन करने का तरीका ऊपर बताया गया है.
Python
पिछले उदाहरण की तरह ही, यह उदाहरण भी मैसेज को base64url पर कोड में बदलने का काम करता है और उसे Message
संसाधन के raw
फ़ील्ड को असाइन करता है.
मैसेज भेजें
मैसेज बनाने के बाद, उसे messages.send
को किए गए कॉल के मैसेज के मुख्य हिस्से में शामिल किया जा सकता है. जैसा कि नीचे दिए गए उदाहरणों में दिखाया गया है.
Java
Python
अगर आपको जवाब भेजना है और ईमेल को थ्रेड पर भेजना है, तो पक्का करें कि:
Subject
हेडर मेल खाते हैंReferences
औरIn-Reply-To
हेडर, आरएफ़सी 2822 स्टैंडर्ड का पालन करते हैं.
ड्राफ़्ट से मैसेज भेजने के बारे में जानकारी पाने के लिए, ड्राफ़्ट बनाना देखें.