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 ऐप्लिकेशन को कॉन्फ़िगर करने और चलाने का तरीका जानने के लिए, क्विकस्टार्ट पढ़ें.