Gmail API, RESTful API है. इसका इस्तेमाल, Gmail के मेलबॉक्स ऐक्सेस करने और ईमेल भेजने के लिए किया जा सकता है. ज़्यादातर वेब ऐप्लिकेशन के लिए, Gmail API, उपयोगकर्ता के Gmail डेटा को अनुमति के साथ ऐक्सेस करने का सबसे अच्छा विकल्प है. यह कई ऐप्लिकेशन के लिए सही है. जैसे:
- सिर्फ़ ईमेल एक्सट्रैक्ट करना, इंडेक्सिंग करना, और बैकअप लेना
- मैसेज को ऑटोमेटेड या प्रोग्राम के ज़रिए भेजना
- ईमेल खाते का माइग्रेशन
- ईमेल को व्यवस्थित करना. इसमें मैसेज को फ़िल्टर करना और क्रम से लगाना शामिल है
- किसी संगठन में सभी ईमेल के लिए एक जैसे हस्ताक्षर सेट करना
सामान्य शब्द
इस एपीआई में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:
- डेलिगेटर और डेलिगेट
- डेलिगेटर, Gmail का वह उपयोगकर्ता होता है जो एक ही Google Workspace संगठन में किसी दूसरे उपयोगकर्ता को मेलबॉक्स का ऐक्सेस देता है. जिस उपयोगकर्ता को यह ऐक्सेस मिलता है वह डेलिगेट होता है. डेलिगेट, डेलिगेटर के खाते से मैसेज पढ़ सकते हैं, भेज सकते हैं, और मिटा सकते हैं. साथ ही, संपर्क देख और जोड़ सकते हैं. ज़्यादा जानकारी के लिए, देखें डेलिगेट मैनेज करना.
- ड्राफ़्ट
- ऐसा मैसेज जिसे भेजा नहीं गया है. ड्राफ़्ट में मौजूद मैसेज को बदला जा सकता है.
ड्राफ़्ट भेजने पर, वह अपने-आप मिट जाता है. साथ ही,
SENTसिस्टम लेबल वाला एक मैसेज बन जाता है. ड्राफ़्ट कोdraftsसंसाधन के तौर पर दिखाया जाता है. ज़्यादा जानकारी के लिए, ड्राफ़्ट के साथ काम करना लेख पढ़ें. - फ़िल्टर
- किसी खाते के लिए कॉन्फ़िगर किए गए ऐडवांस नियम. ये नियम, आने वाले मैसेज की तुलना, मैच करने की खास शर्तों (जैसे, भेजने वाला, विषय या साइज़) से करते हैं. जब कोई मैसेज, शर्तों के मुताबिक होता है, तो फ़िल्टर अपने-आप कार्रवाइयां ट्रिगर करते हैं. जैसे, लेबल जोड़ना या हटाना या ईमेल को किसी तय पते पर फ़ॉरवर्ड करना. ज़्यादा जानकारी के लिए, फ़िल्टर मैनेज करना लेख पढ़ें.
- ईमेल फ़ॉरवर्ड करने के पते
- वे खास और पुष्टि किए गए ईमेल पते जिन्हें किसी उपयोगकर्ता के खाते से, अपने-आप फ़ॉरवर्ड किए गए मैसेज पाने के लिए कॉन्फ़िगर किया जाता है. किसी पते का इस्तेमाल, फ़ॉरवर्ड करने के नियम या फ़िल्टर में करने से पहले, उसे आधिकारिक तौर पर रजिस्टर और वेरिफ़ाई करना ज़रूरी है, ताकि मालिकाना हक साबित किया जा सके. ज़्यादा जानकारी के लिए, फ़ॉरवर्ड करने की सुविधा मैनेज करना लेख पढ़ें.
- लेबल
मैसेज और थ्रेड को व्यवस्थित करने का एक तरीका. उदाहरण के लिए, "taxes" लेबल बनाया जा सकता है और इसे उपयोगकर्ता के टैक्स से जुड़े सभी मैसेज और थ्रेड पर लागू किया जा सकता है. ज़्यादा जानकारी के लिए, लेबल मैनेज करना लेख पढ़ें.
लेबल दो तरह के होते हैं:
- सिस्टम लेबल
- ये लेबल, अंदरूनी तौर पर बनाए जाते हैं. जैसे,
INBOX,TRASHयाSPAM. इन लेबल को मिटाया या बदला नहीं जा सकता. हालांकि, कुछ सिस्टम लेबल, जैसे किINBOXको मैसेज और थ्रेड पर लागू किया जा सकता है या उनसे हटाया जा सकता है. - उपयोगकर्ता लेबल
- ये लेबल, किसी उपयोगकर्ता ने बनाए होते हैं. इन लेबल को उपयोगकर्ता या कोई ऐप्लिकेशन मिटा या बदल सकता है. उपयोगकर्ता लेबल को
labelsसंसाधन के तौर पर दिखाया जाता है.
- मैसेज
एक ईमेल मैसेज. इसमें भेजने वाला, पाने वाले, विषय, और बॉडी की जानकारी होती है. मैसेज बनाने के बाद, उसे बदला नहीं जा सकता. मैसेज को
messagesसंसाधन के तौर पर दिखाया जाता है.- पुश नोटिफ़िकेशन
यह सर्वर-साइड सूचना सिस्टम है, जो Google Cloud Pub/Sub के साथ इंटिग्रेट होता है. ऐप्लिकेशन, मेलबॉक्स को "देख" सकते हैं. साथ ही, Gmail API, वेबहुक या चेतावनियां अपने-आप भेजता है. ऐसा तब होता है, जब कोई बदलाव होता है. जैसे, नया ईमेल आना. इससे, ऐप्लिकेशन को अपडेट के लिए सर्वर को लगातार पोल करने की ज़रूरत नहीं पड़ती. ज़्यादा जानकारी के लिए, पुश नोटिफ़िकेशन लेख पढ़ें.
- एस/एमआईएमई सर्टिफ़िकेट
ये डिजिटल सर्टिफ़िकेट होते हैं. इन्हें, "इस पते से भेजें" के तौर पर सेट किए गए खास उपनामों पर अपलोड किया जाता है. इनकी मदद से, उपयोगकर्ता एन्क्रिप्ट (सुरक्षित) किए गए और डिजिटल तौर पर साइन किए गए ईमेल भेज सकता है. इससे मैसेज की सुरक्षा और भेजने वाले की पुष्टि होती है. ज़्यादा जानकारी के लिए, एस/एमआईएमई सर्टिफ़िकेट मैनेज करना लेख पढ़ें.
- "इस पते से भेजें" के तौर पर सेट किए गए उपनाम
ये अलग-अलग ईमेल पते होते हैं जिनसे किसी खाते को ईमेल भेजने की अनुमति मिलती है. हर खाते में कम से कम एक उपनाम होता है. यह उपनाम, मुख्य ईमेल पते को दिखाता है. उपनाम, Gmail के वेब इंटरफ़ेस में "इस पते से ईमेल भेजें" सुविधा से जुड़े होते हैं. साथ ही, ये हर पते के लिए ईमेल सिग्नेचर कॉन्फ़िगर करने का आधार भी होते हैं. ज़्यादा जानकारी के लिए, उपनाम मैनेज करना लेख पढ़ें.
- थ्रेड
एक ही विषय से जुड़े मैसेज का कलेक्शन. इससे बातचीत बनती है. ईमेल क्लाइंट ऐप्लिकेशन में, थ्रेड तब बनता है, जब एक या उससे ज़्यादा लोग किसी मैसेज का जवाब अपने मैसेज से देते हैं. ज़्यादा जानकारी के लिए, थ्रेड मैनेज करना लेख पढ़ें.
मिलते-जुलते विषय
Google Workspace के एपीआई की मदद से डेवलपमेंट करने के बारे में जानने के लिए, Google Workspace पर डेवलप करना लेख पढ़ें. इसमें, पुष्टि करने और अनुमति देने की प्रोसेस को हैंडल करने के बारे में भी बताया गया है.
Gmail API ऐप्लिकेशन को कॉन्फ़िगर और रन करने का तरीका जानने के लिए, क्विकस्टार्ट लेख पढ़ें.