इस दस्तावेज़ में, Gmail API में ईमेल फ़ॉरवर्ड करने की सुविधा को कॉन्फ़िगर करने का तरीका बताया गया है.
किसी खाते के लिए ईमेल फ़ॉरवर्ड करने की सुविधा कॉन्फ़िगर करने के लिए, settings संसाधन का इस्तेमाल किया जा सकता है. ईमेल को आगे भेजने के लिए किसी ईमेल पते का इस्तेमाल करने के लिए, यह ज़रूरी है कि वह इनमें से कोई एक शर्त पूरी करता हो:
- ईमेल पते की पुष्टि हो गई है. ज़्यादा जानकारी के लिए, ईमेल फ़ॉरवर्ड करने के पते बनाना और उनकी पुष्टि करना लेख पढ़ें.
- ईमेल पता, भेजने वाले के डोमेन का ही हो.
- ईमेल पता, उसी डोमेन के सबडोमेन से जुड़ा हो जिससे ईमेल भेजा गया है.
- ईमेल पता, उसी Google Workspace खाते के लिए कॉन्फ़िगर किए गए डोमेन एलियास से जुड़ा है.
अगर फ़ॉरवर्ड करने के लिए इस्तेमाल किया जा रहा ईमेल पता इनमें से किसी नियम का पालन नहीं करता है, तो एपीआई का इस्तेमाल करके ईमेल फ़ॉरवर्ड करने की सुविधा सेट अप नहीं की जा सकेगी.
फ़ॉरवर्डिंग पते बनाने, सूचीबद्ध करने, पाने या मिटाने के तरीके जानने के लिए, settings.forwardingAddresses संसाधन देखें.
ईमेल अपने-आप फ़ॉरवर्ड होने की सेटिंग को पाने या अपडेट करने के तरीके के बारे में जानने के लिए, settings संसाधन में दिए गए तरीके देखें.
ईमेल फ़ॉरवर्ड करने के पते बनाना और उनकी पुष्टि करना
आपको फ़ॉरवर्डिंग पतों का इस्तेमाल करने से पहले, उन्हें बनाना होगा. कुछ मामलों में, उपयोगकर्ताओं को पते के मालिकाना हक की पुष्टि भी करनी होगी.
अगर Gmail को किसी फ़ॉरवर्ड करने के पते के लिए उपयोगकर्ता की पुष्टि करनी होती है, तो एपीआई उस पते को VerificationStatus
pending के साथ दिखाता है. Gmail, टारगेट किए गए ईमेल पते पर पुष्टि करने के लिए एक मैसेज अपने-आप भेजता है. ईमेल पते का इस्तेमाल करने से पहले, उसके मालिक को पुष्टि की प्रक्रिया पूरी करनी होगी.
जिन फ़ॉरवर्डिंग पतों की पुष्टि करने की ज़रूरत नहीं होती है उनके लिए, पुष्टि की स्थिति accepted के तौर पर दिखती है.
मैसेज, अपने-आप फ़ॉरवर्ड करने की सुविधा चालू करना
आपके पास अपने सभी नए मैसेज को किसी दूसरे ईमेल पते पर फ़ॉरवर्ड करने का विकल्प होता है.
इसके लिए, किसी खाते के लिए अपने-आप फ़ॉरवर्ड होने की सुविधा चालू करने के लिए, updateAutoForwarding तरीके का इस्तेमाल करें. इसके लिए, रजिस्टर किया गया और पुष्टि किया गया फ़ॉरवर्ड करने का पता होना चाहिए. साथ ही, फ़ॉरवर्ड किए गए मैसेज पर की जाने वाली कार्रवाई की जानकारी होनी चाहिए.
इन वैल्यू को AutoForwarding ऑब्जेक्ट में सेट करें.
मैसेज फ़ॉरवर्ड होने के बाद, मैसेज का स्टेटस सेट करने के लिए, disposition फ़ील्ड का इस्तेमाल करें. इस फ़ील्ड की डिफ़ॉल्ट वैल्यू dispositionUnspecified होती है. हालांकि, इस फ़ील्ड को dispositionUnspecified पर सेट नहीं किया जा सकता.
नीचे दिए गए कोड सैंपल में, ईमेल अपने-आप फ़ॉरवर्ड होने की सुविधा चालू करने और फ़ॉरवर्ड किए गए ईमेल को ट्रैश में ले जाने का तरीका बताया गया है:
Java
Python
अपने-आप फ़ॉरवर्ड होने की सुविधा बंद करने के लिए, updateAutoForwarding तरीके को कॉल करें और AutoForwarding ऑब्जेक्ट पर enabled फ़ील्ड को false पर सेट करें.
चुनिंदा मैसेज फ़ॉरवर्ड करना
अपने-आप फ़ॉरवर्ड होने की सुविधा चालू होने पर, Gmail पर मिले सभी ईमेल, टारगेट खाते पर भेज दिए जाते हैं. कुछ खास मैसेज फ़ॉरवर्ड करने के लिए, फ़िल्टर सेट अप करें. इससे ऐसे नियम बनाए जा सकते हैं जो मैसेज के एट्रिब्यूट या कॉन्टेंट के आधार पर मैसेज फ़ॉरवर्ड करते हैं.
ईमेल को कई खातों पर फ़ॉरवर्ड करने के लिए, ईमेल फ़ॉरवर्ड करने के लिए चुने गए हर ईमेल पते के लिए एक फ़िल्टर बनाएं.