अस्वीकरण – यह थोड़ा तकनीकी पोस्ट होने जा रहा है। यदि कोड आपको डराता है, तो मैं सुझाव दूंगा कि आप इसे छोड़ दें। हालांकि, अगर डेटा आपको उत्तेजित करता है, तो साथी साहसी पर पढ़ें!
जब Google ने Google डेटा स्टूडियो लॉन्च किया था, तो मैंने एक गहराई से पोस्ट लिखा था कि डेटा स्टूडियो में डैशबोर्ड कैसे बना सकते हैं और डेटा स्टूडियो को पेश करने वाले डैशबोर्ड टेम्पलेट्स का उपयोग करने में कुछ आसान हैं। जैसा कि उत्पाद विकसित हुआ, इस उत्पाद को पेश करने वाली सबसे शक्तिशाली विशेषताओं में से एक आपके अपने डेटासेट में कस्टम डेटा कनेक्टर बनाने की क्षमता थी।
एक कस्टम कनेक्टर क्या करता है?
एक कस्टम कनेक्टर उपयोगकर्ता को Google डेटा स्टूडियो के भीतर अपने स्वयं के डेटा स्रोत तक पहुंचने में सक्षम बनाता है। आइए एक मार्केटिंग रिसर्च एसोसिएट का उदाहरण लें जो अपने निष्कर्षों को पेश करना चाहता है। एक दृष्टिकोण वह उपयोग कर सकते है कि सभी डेटा गूगल शीट्स में डाल दिया जाएगा, और फिर में निर्मित कनेक्टर्स में से एक का उपयोग करें ।
हालांकि, अगर उसका डेटा सेट बड़ा था और गूगल शीट या एक्सेल में फिट नहीं होता है तो वह क्या करेगी? या यदि उसके डेटा सेट में कई सर्वेक्षण शामिल हैं जो एक दूसरे से अंतर-संबंधित हैं?
क्या होगा यदि यह डेटा डेटाबेस में था, या एपीआई के रूप में उपलब्ध था? यह वह जगह है जहां Google डेटा स्टूडियो के लिए कस्टम कनेक्टर काम करता है।
मैं अपनी पहली कनेक्टर एक साल पहले लिखा था, और मैं कुछ खुदाई के आसपास करना था । मैंने सोचा कि मुझे अपने नोट्स को पेन करना चाहिए ताकि ज्यादा लोग इसे और आसानी से कर सकें । यहां उसी के लिए मेरे नोट्स हैं ।
एक कस्टम कनेक्टर का निर्माण
कार्यान्वयन बिट में कूदने से पहले, जानें कि यह जावास्क्रिप्ट में आधारित है और आपको Google ऐप स्क्रिप्ट के साथ सहज होने की आवश्यकता है। यदि आप यह नहीं जानते हैं, तो यह ठीक है, लेकिन जावास्क्रिप्ट बहुत जरूरी है।
Google के पास डेवलपर साइट पर आधिकारिक दस्तावेज हैं कि एक समुदाय कनेक्टर कैसे बनाया जाए,यह शुरू करने के लिए एक बहुत अच्छा संसाधन है। इसमें स्टेप बाय स्टेप वीडियो और इंस्ट्रक्शन गाइड भी है।
आइए देखें कि कनेक्टर के विभिन्न हिस्सों को क्या बनाता है, यहां गिथुब परएक नमूना कनेक्टर कोड का लिंक है।
समुदाय कनेक्टर अनुभाग
प्रत्येक समुदाय कनेक्टर एक अलग Google ऐप्लिकेशन स्क्रिप्ट है जिसे आप Google ऐप्लिकेशन स्क्रिप्ट का उपयोग करके तैनात करते हैं. कनेक्टर अपने आप में निम्नलिखित वर्गों से बना है –
- कॉन्फ़िगरेशन सेक्शन – यह समुदाय कनेक्टर के बारे में सभी मेटा जानकारी को मांस देने के लिए है। यदि आप इसे अपने कोड में स्टोर नहीं करना चाहते हैं तो उपयोगकर्ता जैसे एपीआई सीक्रेट और कुंजी से कोई भी इनपुट लेने के लिए इस अनुभाग का उपयोग करें।
- प्रमाणीकरण अनुभाग – यह ऐप स्क्रिप्ट को अधिकृत करने के लिए है। यदि आपका डेटा एक सुरक्षित तंत्र के पीछे पड़ा है, तो डेटा तक पहुंचने के लिए स्क्रिप्ट को अधिकृत करने के लिए इस अनुभाग का उपयोग करें। यह OAuth2 के रूप में अच्छी तरह से समर्थन करता है ।
- स्कीमा अनुभाग – इसका उपयोग डेटा स्टूडियो में आयात किए जा रहे डेटा के लिए संरचना को परिभाषित करने के लिए किया जाता है। इस अनुभाग का उपयोग यह रेखांकित करने के लिए करें कि वे कौन से फ़ील्ड और कौन से डेटा प्रकार हैं. आप इस बारे में अधिक जानकारी भी जोड़ सकते हैं कि आप इस क्षेत्र को किस प्रकार का एकत्रीकरण करना चाहते हैं (राशि, औसत, न्यूनतम, अधिकतम, आदि)।
- डेटा अनुभाग – इस अनुभाग का उपयोग आपके द्वारा आयात किए जा रहे डेटा को लाने के लिए किया जाता है। डेटा सत्यापन के लिए इस अनुभाग का उपयोग करें या यदि आप कोई अंतिम मिनट डेटा ट्विक करना चाहते हैं (उदाहरण के लिए स्ट्रिंग से डेट रूपांतरण)।
यह सब वहां है । अब, हमें पटकथा के वास्तविक प्रवाह में जाना चाहिए ।
कनेक्टर कोड फ्लो
जब आप अपना कनेक्टर लिख रहे हैं, तो पहले डेवलपर संदर्भ के माध्यम से जाना सुनिश्चित करें। अपनी स्क्रिप्ट में, आपको निम्नलिखित कार्यों को शामिल करना होगा –
- getConfig () – यह कनेक्टर के लिए विन्यास उपयोगकर्ता विकल्प देता है, यह उपयोगकर्ता को दिखाया जाएगा जब उपयोगकर्ता अपने Google डेटा स्टूडियो खातों में कनेक्टर जोड़ रहा है।
- getAuthType ()- यह वह समारोह है जिसका उपयोग यह जांचने के लिए किया जाता है कि क्या किसी प्रमाणीकरण की आवश्यकता है। यदि OAuth सेट है, तो समुदाय कनेक्टर इंटरफेस OAuth विवरण के लिए जांच करेंगे
- getSchema () – यह एक्सेस किए जा रहे डेटा की स्कीमा देता है, यह उपयोगकर्ता को दिखाया जाएगा जब डेटा का पता लगाया जा रहा है (जहां हम आयाम और मैट्रिक्स देख सकते हैं)।
- getData ()- यह वह फ़ंक्शन है जिसका उपयोग डेटा तक पहुंचने के लिए किया जाता है, डेटा प्रारूप जो अपेक्षित है, यहांरेखांकित किया गया है। आम तौर पर, यह सलाह दी जाती है कि प्रोग्रामर डेटा लाने के लिए एक अलग फ़ंक्शन लिखता है, रिटर्न मूल्यों को स्थापित करने के लिए एक पोस्ट प्रोसेसिंग फ़ंक्शन, और अंत में इस फ़ंक्शन में सही क्रम में उन लोगों को बुलाता है।
ध्यान दें, कि इन कार्यों को उसी क्रम में बुलाया जाएगा जैसा कि वे सूचीबद्ध हैं। जब तक आपके कोड में ये कार्य हैं, तब तक आपके पास एक कार्यकंचालक है। एक बार जब आपके पास यह हो जाता है, तो आपको कोड को तैनातकरना होगा।
बस. अब, इस समुदाय कनेक्टर को अपने Google डेटा स्टूडियो खाते में जोड़ें, और आप जो रिपोर्ट चाहते हैं उसे बनाएं!