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