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