इस गाइड में, मेल मर्ज करने के लिए Google Docs API का इस्तेमाल करने का तरीका बताया गया है.
परिचय
मेल मर्ज की सुविधा, स्प्रेडशीट या किसी अन्य डेटा सोर्स की लाइनों से वैल्यू लेती है और उन्हें टेंप्लेट दस्तावेज़ में डालती है. इस सुविधा की मदद से, एक प्राइमरी दस्तावेज़ (टेंप्लेट) बनाया जा सकता है. इससे मिलते-जुलते कई दस्तावेज़ जनरेट किए जा सकते हैं. हर दस्तावेज़ में, मर्ज किए जा रहे डेटा के हिसाब से बदलाव किया जा सकता है. ज़रूरी नहीं कि इस नतीजे का इस्तेमाल, डाक या फ़ॉर्म लेटर के लिए किया जाए. इसका इस्तेमाल किसी भी मकसद के लिए किया जा सकता है. जैसे, ग्राहकों के इनवॉइस का बैच जनरेट करना.
स्प्रेडशीट और वर्ड प्रोसेसर के आने के बाद से ही, मेल मर्ज की सुविधा उपलब्ध है. आज यह कई कारोबारी वर्कफ़्लो का हिस्सा है. डेटा को इस तरह से व्यवस्थित किया जाता है कि हर पंक्ति में एक रिकॉर्ड हो. साथ ही, कॉलम में डेटा के फ़ील्ड दिखें. इसकी जानकारी यहां दी गई है:
नाम | पता | ज़ोन | |
---|---|---|---|
1 | UrbanPq | 123 पहली सड़क | पश्चिम |
2 | Pawxana | 456 2nd St. | दक्षिण |
इस पेज पर मौजूद सैंपल ऐप्लिकेशन में दिखाया गया है कि Google Docs, Sheets, और Drive API का इस्तेमाल करके, मेल मर्ज की प्रोसेस की जानकारी को कैसे छिपाया जा सकता है. इससे उपयोगकर्ताओं को लागू करने से जुड़ी समस्याओं से बचाया जा सकता है. इस Python सैंपल के बारे में ज़्यादा जानकारी, सैंपल के GitHub रिपो पर देखी जा सकती है.
सैंपल ऐप्लिकेशन
यह सैंपल ऐप्लिकेशन, आपके प्राइमरी टेंप्लेट को कॉपी करता है. इसके बाद, आपके चुने गए डेटा सोर्स से वैरिएबल को हर कॉपी में मर्ज करता है. इस सैंपल ऐप्लिकेशन को आज़माने के लिए, सबसे पहले अपना टेंप्लेट सेट अप करें:
- Docs फ़ाइल बनाएं. वह टेंप्लेट चुनें जिसका आपको इस्तेमाल करना है.
- नई फ़ाइल का दस्तावेज़ आईडी नोट करें. ज़्यादा जानकारी के लिए, दस्तावेज़ आईडी देखें.
DOCS_FILE_ID
वैरिएबल को दस्तावेज़ आईडी पर सेट करें.- संपर्क जानकारी की जगह, टेंप्लेट के प्लेसहोल्डर वैरिएबल का इस्तेमाल करें. ऐप्लिकेशन, इन्हें चुने गए डेटा के साथ मर्ज कर देगा.
यहां सैंपल लेटर टेंप्लेट दिया गया है. इसमें ऐसे प्लेसहोल्डर हैं जिन्हें सादे टेक्स्ट या Sheets जैसे सोर्स से मिले असल डेटा के साथ मर्ज किया जा सकता है. यह टेंप्लेट ऐसा दिखता है:
इसके बाद, SOURCE
वैरिएबल का इस्तेमाल करके, अपने डेटा सोर्स के तौर पर सामान्य टेक्स्ट या Sheets में से कोई एक चुनें. डिफ़ॉल्ट रूप से सैंपल, सामान्य टेक्स्ट के तौर पर दिखता है. इसका मतलब है कि सैंपल डेटा, TEXT_SOURCE_DATA
वैरिएबल का इस्तेमाल करता है. Sheets से डेटा सोर्स करने के लिए, SOURCE
वैरिएबल को 'sheets'
पर अपडेट करें. इसके बाद, SHEETS_FILE_ID
वैरिएबल सेट करके, इसे हमारी सैंपल शीट (या अपनी शीट) पर पॉइंट करें.
यहां शीट का फ़ॉर्मैट दिखाया गया है, ताकि आपको पता चल सके कि यह कैसी दिखती है:
हमारे सैंपल डेटा के साथ ऐप्लिकेशन को आज़माएं. इसके बाद, इसे अपने डेटा और इस्तेमाल के उदाहरण के हिसाब से ढालें. कमांड-लाइन ऐप्लिकेशन इस तरह काम करता है:
- सेटअप
- डेटा सोर्स से डेटा फ़ेच करना
- डेटा की हर लाइन को लूप करें
- टेंप्लेट की कॉपी बनाना
- कॉपी किए गए डेटा को ओरिजनल डेटा के साथ मर्ज करना
- मर्ज किए गए नए दस्तावेज़ का लिंक
मर्ज किए गए सभी नए दस्तावेज़, उपयोगकर्ता की 'मेरी ड्राइव' में भी दिखते हैं. मर्ज किए गए पत्र का उदाहरण कुछ ऐसा दिखता है:
सोर्स कोड
Python
ज़्यादा जानकारी के लिए, README
फ़ाइल देखें. साथ ही, सैंपल ऐप्लिकेशन के GitHub रेपो में जाकर, ऐप्लिकेशन का पूरा सोर्स कोड देखें.
मिलते-जुलते विषय
- मेल मर्ज की सुविधा का इस्तेमाल करके, पसंद के मुताबिक बनाए गए ईमेल भेजना
- Gmail और Google Sheets का इस्तेमाल करके मेल मर्ज बनाना