इस दस्तावेज़ में, Gmail API का इस्तेमाल करके, ईमेल के ड्राफ़्ट बनाने, उन्हें अपडेट करने, और भेजने का तरीका बताया गया है.
ईमेल के ड्राफ़्ट, ऐसे मैसेज होते हैं जिन्हें भेजा नहीं गया है. इन पर DRAFT सिस्टम लेबल लागू होता है.
ड्राफ़्ट में मौजूद मैसेज को बनाने के बाद, उसमें बदलाव नहीं किया जा सकता. हालांकि, उसे बदला जा सकता है. इस मामले में, the
drafts संसाधन एक
कंटेनर होता है, जो एक स्टेबल आईडी उपलब्ध कराता है. ऐसा इसलिए, क्योंकि मैसेज को बदलने पर, उसके आईडी भी बदल जाते हैं.
ड्राफ़्ट में मौजूद messages संसाधन
का व्यवहार, अन्य मैसेज की तरह ही होता है. हालांकि, इनमें ये
अंतर होते हैं:
- ड्राफ़्ट मैसेज में,
DRAFTसिस्टम लेबल के अलावा कोई और लेबल नहीं हो सकता. - ड्राफ़्ट भेजे जाने पर, वह अपने-आप मिट जाता है. साथ ही,
SENTसिस्टम लेबल के साथ, अपडेट किए गए आईडी वाला एक नया मैसेज बन जाता है. `method` तरीके के जवाब में, यह मैसेज दिखता है.drafts.send
ड्राफ़्ट बनाना
आपका ऐप्लिकेशन, ड्राफ़्ट बनाने के लिए
drafts.create
तरीके का इस्तेमाल कर सकता है. ड्राफ़्ट बनाने के लिए:
- RFC 2822 के मुताबिक, MIME मैसेज बनाएं.
- मैसेज को 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 फ़ील्ड को base64URL एन्कोडेड स्ट्रिंग पर सेट करना होगा. इसमें MIME मैसेज शामिल होता है. मैसेज को अपडेट नहीं किया जा सकता. इसलिए, ड्राफ़्ट में मौजूद मैसेज मिट जाता है और उसकी जगह, अपडेट के अनुरोध में दिया गया नया MIME मैसेज आ जाता है.
ड्राफ़्ट में मौजूद मौजूदा MIME मैसेज को वापस पाने के लिए,
drafts.get तरीके को क्वेरी पैरामीटर format=raw के साथ कॉल करें.
ज़्यादा जानकारी के लिए, drafts.update
तरीका देखें.
ड्राफ़्ट भेजना
ड्राफ़्ट भेजते समय, उसे बिना किसी बदलाव के भेजा जा सकता है. इसके अलावा, भेजने के अनुरोध में अपडेट भी दिए जा सकते हैं.
भेजते समय ड्राफ़्ट को अपडेट करने के लिए, अनुरोध के मुख्य हिस्से
में drafts.send
तरीके का drafts संसाधन दें. drafts संसाधन में, आपको भेजे जाने वाले ड्राफ़्ट का ड्राफ़्ट
id बताना होगा. साथ ही, messages.raw फ़ील्ड को base64URL स्ट्रिंग के तौर पर एन्कोड किए गए नए MIME मैसेज
पर सेट करना होगा.
Gmail से मैसेज भेजने के बारे में जानकारी पाने के लिए, मैसेज भेजना लेख पढ़ें.