इस दस्तावेज़ में, Gmail API का इस्तेमाल करके ड्राफ़्ट ईमेल बनाने, अपडेट करने, और भेजने का तरीका बताया गया है.
ईमेल के ड्राफ़्ट, ऐसे मैसेज होते हैं जिन्हें भेजा नहीं गया है. इन पर DRAFT सिस्टम लेबल लागू होता है.
ड्राफ़्ट में मौजूद मैसेज को बनाने के बाद, उसमें बदलाव नहीं किया जा सकता. हालांकि, उसे बदला जा सकता है. इस हिसाब से, drafts रिसॉर्स एक कंटेनर है. यह एक स्टेबल आईडी देता है, क्योंकि मैसेज बदले जाने पर, मैसेज आईडी भी बदल जाते हैं.
ड्राफ़्ट में मौजूद messages संसाधन, अन्य मैसेज की तरह ही काम करता है. हालांकि, इसमें ये अंतर होते हैं:
- ड्राफ़्ट किए गए मैसेज में,
DRAFTसिस्टम लेबल के अलावा कोई और लेबल नहीं हो सकता. - ड्राफ़्ट भेजने पर, वह अपने-आप मिट जाता है. साथ ही, अपडेट किए गए आईडी वाला एक नया मैसेज,
SENTसिस्टम लेबल के साथ बन जाता है. यह मैसेज,drafts.sendतरीके के जवाब में दिखता है.
ड्राफ़्ट बनाना
आपका ऐप्लिकेशन, drafts.create तरीके का इस्तेमाल करके ड्राफ़्ट बना सकता है. कोई ड्राफ़्ट बनाने के लिए:
- ऐसा MIME मैसेज बनाएं जो RFC 2822 के मुताबिक हो.
- मैसेज को base64URL कोड में बदली गई स्ट्रिंग में बदलें.
drafts.createतरीके को कॉल करें औरmessages.rawफ़ील्ड की वैल्यू को एन्कोड की गई स्ट्रिंग पर सेट करें.
नीचे दिए गए कोड सैंपल में, इस प्रोसेस के बारे में बताया गया है:
Java
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
इनकी जगह ये डालें:
- ACCESS_TOKEN: यह ऐक्सेस टोकन है, जो एपीआई का ऐक्सेस देता है.
- MESSAGE: RFC 2822 फ़ॉर्मैट किया गया MIME मैसेज, जिसे base64URL के तौर पर कोड में बदला गया है.
ड्राफ़्ट अपडेट करें
ड्राफ़्ट बनाने की तरह ही, ड्राफ़्ट को अपडेट करने के लिए भी आपको अपने अनुरोध के मुख्य हिस्से में drafts रिसॉर्स देना होगा. साथ ही, messages.raw फ़ील्ड को MIME मैसेज वाली base64URL एन्कोड की गई स्ट्रिंग पर सेट करना होगा. मैसेज अपडेट नहीं किए जा सकते. इसलिए, ड्राफ़्ट में मौजूद मैसेज मिटा दिया जाता है और अपडेट के अनुरोध में दिए गए नए MIME मैसेज से बदल दिया जाता है.
drafts.get तरीके को कॉल करके, ड्राफ़्ट में मौजूद मौजूदा MIME मैसेज को वापस पाया जा सकता है. इसके लिए, क्वेरी पैरामीटर format=raw का इस्तेमाल करें.
ज़्यादा जानकारी के लिए, drafts.update तरीका देखें.
ड्राफ़्ट किए गए ईमेल भेजना
ड्राफ़्ट भेजते समय, उसे बिना किसी बदलाव के भेजा जा सकता है. इसके अलावा, अनुरोध भेजते समय अपडेट भी दिए जा सकते हैं.
भेजते समय ड्राफ़्ट को अपडेट करने के लिए, drafts.send तरीके के अनुरोध के मुख्य हिस्से में drafts संसाधन उपलब्ध कराएं. drafts संसाधन में, आपको भेजे जाने वाले ड्राफ़्ट का ड्राफ़्ट
id तय करना होगा. साथ ही, messages.raw फ़ील्ड को नए MIME मैसेज पर सेट करना होगा. यह मैसेज, base64URL स्ट्रिंग के तौर पर कोड में बदला गया होता है.
Gmail से मैसेज भेजने के बारे में जानकारी के लिए, मैसेज भेजना लेख पढ़ें.