पार्टनर कनेक्टर के लिए ज़रूरी शर्तें

कनेक्टर पब्लिश करने के फ़ायदों और इसके लिए ज़रूरी शर्तों को समझने के लिए, पब्लिश करने की खास जानकारी देखें. पार्टनर कनेक्टर पब्लिश करने के लिए, आपके कनेक्टर को यहां बताई गई सभी ज़रूरी शर्तें पूरी करनी होंगी.

Apps Script

समीक्षा के लिए कनेक्टर सबमिट करने से पहले, Apps Script में यह काम पूरा करें:

1. अपने Apps Script प्रोजेक्ट का देखने का ऐक्सेस शेयर करें. इसके लिए, यह तरीका अपनाएं:
   • [e-mail]
   • [e-mail]
2. Production नाम का डिप्लॉयमेंट बनाएं. इसके बाद, Production डिप्लॉयमेंट को कोड के उस वर्शन पर अपडेट करें जिसे आपको पब्लिश करना है.
3. पुष्टि करें कि आपने Production डिप्लॉयमेंट को उस कोड के वर्शन पर अपडेट कर दिया है जिसकी समीक्षा करानी है.
4. पुष्टि करें कि मेनिफ़ेस्ट फ़ाइल, Apps Script में दिख रही हो. बाईं ओर, प्रोजेक्ट की सेटिंग पर क्लिक करें. मेनिफ़ेस्ट फ़ाइल "appsscript.json" एडिटर में दिखाएं चेकबॉक्स को चुनें.

मेनिफ़ेस्ट

अपने कनेक्टर के मेनिफ़ेस्ट में यहां दी गई जानकारी शामिल करें. साथ ही, पुष्टि करें कि आपका Apps Script प्रोजेक्ट, एडिटर में appsscript.json मेनिफ़ेस्ट फ़ाइल दिखाने के लिए कॉन्फ़िगर किया गया हो.

ज़्यादा जानकारी के लिए, कम्यूनिटी कनेक्टर के मेनिफ़ेस्ट का रेफ़रंस देखें.

dataStudio

1. description में कनेक्टर के बारे में बुनियादी जानकारी और उसे इस्तेमाल करने के निर्देश दिए जाने चाहिए. जिन कनेक्टर के बारे में साफ़ तौर पर और पूरी जानकारी नहीं दी गई है उन्हें अस्वीकार कर दिया जाएगा.
2. addOnUrl आपके कनेक्टर के बारे में जानकारी देने वाला एक होस्ट किया गया पेज होना चाहिए. इसे बेहतर होगा कि आप अपने डोमेन पर होस्ट करें. पेज पर यह जानकारी शामिल होनी चाहिए:
   • addOnUrl के डोमेन पर, निजता नीति और इस्तेमाल की शर्तें या इस कॉन्टेंट का लिंक मौजूद होना चाहिए.
   • आपके कनेक्टर का इस्तेमाल करने के लिए, उपयोगकर्ता को यह जानकारी देनी होगी.
   • साइन अप करने का लिंक. यह तब ज़रूरी होता है, जब कनेक्टर का इस्तेमाल करने के लिए किसी खाते की ज़रूरत हो.
   • कॉन्टेंट को आपके डोमेन पर होस्ट किया गया हो. https://sites.google.com/ पर होस्ट करने की अनुमति नहीं है.
   • मौजूदा पार्टनर के उदाहरण पेज देखें: Funnel, Supermetrics, CallRail.
3. supportUrl एक होस्ट किया गया पेज होना चाहिए, ताकि आपको अपने कनेक्टर के लिए सहायता मिल सके. यह ईमेल या mailto लिंक नहीं हो सकता.
4. logoUrl आपके कंट्रोल में होस्ट की गई किसी स्टैटिक इमेज पर ले जाना चाहिए. Google की सेवाओं से दिखाई गई इमेज का इस्तेमाल, *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com जैसे डोमेन पर नहीं किया जा सकता. *.googleapis.com डोमेन से इमेज दिखाने के लिए, Google Cloud Storage का इस्तेमाल किया जा सकता है. साथ ही, हमारा सुझाव है कि आप होस्टिंग के लिए इसी विकल्प का इस्तेमाल करें.
   • ऐनिमेटेड आइकॉन वाले कनेक्टर अस्वीकार कर दिए जाएंगे. स्टैटिक इमेज का इस्तेमाल करें.
   • हमारा सुझाव है कि कम से कम 48x48 पिक्सल वाली इमेज का इस्तेमाल करें.
   • सिर्फ़ टेक्स्ट वाली ऐसी इमेज इस्तेमाल न करें जिन्हें 48x48 पिक्सल के हिसाब से छोटा करने पर पढ़ना मुश्किल हो.
5. sources प्रॉपर्टी में, उन सभी सोर्स का डेटा शामिल करें जिनसे आपका कनेक्टर कनेक्ट होता है. ज़्यादा जानकारी के लिए, मेनिफ़ेस्ट रेफ़रंस में मौजूद सोर्स देखें.
   • सोर्स की मौजूदा सूची को डेटा रजिस्ट्री रिपॉज़िटरी में देखा जा सकता है. अगर आपको जिस सोर्स से कनेक्ट करना है वह रिपॉज़िटरी में मौजूद नहीं है, तो सोर्स को जोड़ने के लिए डेटा रजिस्ट्री रिपॉज़िटरी को पुल अनुरोध भेजें. अगर आपके मेनिफ़ेस्ट में मौजूद सोर्स, रिपॉज़िटरी में मौजूद नहीं हैं, तो आपका कनेक्टर समीक्षा की प्रोसेस पूरी नहीं कर पाएगा.
   • यह कनेक्टर के लिए अतिरिक्त मेटाडेटा है. इसे गैलरी में खोज सुविधा के लिए इंडेक्स किया जाएगा. जब उपयोगकर्ता गैलरी में किसी सोर्स को खोजेंगे, तब खोज के नतीजों में आपका कनेक्टर दिखेगा.
6. shortDescription, authType, feeType, privacyPolicyUrl, और termsOfServiceUrl के लिए वैल्यू दें.
7. name से कनेक्टर के मकसद के बारे में सीधे तौर पर पता चलना चाहिए. कनेक्टर का नाम साफ़ तौर पर बताने से, लोगों को यह तय करने में मदद मिलेगी कि यह उनकी ज़रूरतों के मुताबिक है या नहीं. नाम में कनेक्टर शब्द का इस्तेमाल न करें, क्योंकि लोगों को पहले से ही पता होता है कि वे किसी कनेक्टर को देख रहे हैं.
   • कनेक्टर की पोज़िशन बदलने या लोगों का ध्यान खींचने के लिए, खास या न दिखने वाले वर्ण शामिल न करें.
8. मेनिफ़ेस्ट में कहीं भी Data Studio के लिए छोटे नामों का इस्तेमाल न करें. जैसे, GDS, DS वगैरह.
9. किसी भी मेनिफ़ेस्ट फ़ील्ड में इमोजी इस्तेमाल करने की अनुमति नहीं है (description, shortDescription, name वगैरह). आम तौर पर, अपने कनेक्टर की ओर लोगों का ध्यान खींचने के लिए, खास या न दिखने वाले वर्ण शामिल न करें.
10. अगर आपके कनेक्टर का स्कीमा तय है, तो अपने कनेक्टर के लिए रिपोर्ट टेंप्लेट बनाएं और उसे मेनिफ़ेस्ट में जोड़ें. रिपोर्ट के लिए, लिंक शेयर करने की सुविधा चालू करें.
    

urlFetchWhitelist

1. UrlFetchApp से कॉल किए गए एंडपॉइंट की संख्या को सिर्फ़ उन एंडपॉइंट तक सीमित करें जो कनेक्टर के काम करने के लिए ज़रूरी हैं. अपने मेनिफ़ेस्ट के रूट लेवल में urlFetchWhitelist प्रॉपर्टी जोड़ें. ज़्यादा जानकारी के लिए, urlFetchWhitelist का रेफ़रंस देखें.
   
   • UrlFetchApp सेवा के साथ इस्तेमाल किए गए सभी एंडपॉइंट शामिल करें.
   • अगर आपका कनेक्टर, UrlFetchApp service का इस्तेमाल करके संसाधन नहीं फ़ेच करता है, तो urlFetchWhitelist को खाली सूची [] पर सेट करें.
   • अगर आपका कनेक्टर, तय किए गए एंडपॉइंट के सेट से कनेक्ट नहीं होता है या एंडपॉइंट का प्रीफ़िक्स अलग-अलग होता है, तो urlFetchWhitelist प्रॉपर्टी को शामिल न करें. साथ ही, समीक्षा का अनुरोध सबमिट करते समय, urlFetchWhitelist के लिए अपवाद फ़ॉर्म फ़ील्ड में जानकारी दें.

oauthScopes

1. मेनिफ़ेस्ट में, OAuth के स्कोप साफ़ तौर पर सेट करें. जिन कनेक्टर में OAuth स्कोप के बारे में साफ़ तौर पर जानकारी नहीं दी गई है उन्हें अस्वीकार कर दिया जाएगा.

कनेक्टर

1. अगर उपयोगकर्ता को कनेक्टर का इस्तेमाल करने के लिए खाते की ज़रूरत है, तो पक्का करें कि कनेक्टर description या addOnUrl लिंक में, उपयोगकर्ता को खाता बनाने के बारे में निर्देश दिए गए हों.
2. आपका कनेक्टर, बीटा वर्शन में या अधूरा नहीं होना चाहिए. आपको पूरी तरह से काम करने वाला कनेक्टर पब्लिश करना होगा. कनेक्टर को कभी भी अपडेट किया जा सकता है. हालांकि, उपयोगकर्ताओं के लिए रिलीज़ किए गए प्रोडक्शन डिप्लॉयमेंट की जांच की जानी चाहिए. साथ ही, उसमें सभी सुविधाएं मौजूद होनी चाहिए.
3. जब उपयोगकर्ताओं को कनेक्टर से जुड़ी कोई गड़बड़ी दिखे, तब उन्हें काम के और कार्रवाई करने लायक गड़बड़ी के मैसेज दिखाएं. इसमें ऐसे मामले भी शामिल हैं जिनमें उपयोगकर्ता कॉन्फ़िगरेशन के दौरान अमान्य/खाली इनपुट देता है.
4. shortDescription, description, addOnUrl लिंक, supportUrl लिंक, और OAuth पेज (अगर लागू हो) में स्पेलिंग और व्याकरण से जुड़ी कोई गड़बड़ी नहीं होनी चाहिए.
5. shortDescription में यूआरएल नहीं हो सकते.
6. getAuthType() की ओर से उपलब्ध कराए गए पुष्टि करने के तरीकों का इस्तेमाल करें. getConfig() के ज़रिए क्रेडेंशियल का अनुरोध न करें.
   
7. OAuth क्लाइंट की पुष्टि करने की प्रक्रिया पूरी करें. getAuthType() में पुष्टि करने के तरीके से कोई फ़र्क़ नहीं पड़ता. सभी कनेक्टर के लिए पुष्टि करना ज़रूरी है. पुष्टि करने की प्रोसेस, कनेक्टर की समीक्षा करने की प्रोसेस से अलग होती है. इसे Data Studio नहीं, बल्कि एक अलग टीम मैनेज करती है. ज़्यादा जानकारी के लिए, OAuth API की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल देखें. अगर OAuth क्लाइंट की पुष्टि करने की प्रोसेस पूरी नहीं की जाती है, तो आपके कनेक्टर को अस्वीकार कर दिया जाएगा.
   
   • OAuth की पुष्टि करने की प्रोसेस के दौरान, OAuth के लिए सहमति की स्क्रीन के कॉन्फ़िगरेशन के हिस्से के तौर पर, अपने कनेक्टर के लिए ज़रूरी OAuth स्कोप जोड़ें. अगर आपने ज़रूरी सभी स्कोप नहीं जोड़े हैं, तो हो सकता है कि आप OAuth की पुष्टि करने की प्रोसेस पूरी कर लें. हालांकि, आपका कनेक्टर अब भी पुष्टि नहीं किए गए ऐप्लिकेशन की स्क्रीन दिखाएगा. इससे Partner Connector की पुष्टि करने की प्रोसेस पूरी नहीं हो पाएगी.
     OAuth की पुष्टि करने की प्रोसेस पूरी होने के बाद, नए खाते का इस्तेमाल करके अपने कनेक्टर को अनुमति दें और उसकी जांच करें. इससे यह पक्का किया जा सकेगा कि आपके उपयोगकर्ताओं को पुष्टि न किए गए ऐप्लिकेशन की स्क्रीन न दिखे.
8. पक्का करें कि आपने Data Studio Galleries की सेवा की शर्तों (सबमिट करने वाले के लिए) का पालन किया हो.

सभी ज़रूरी शर्तें पूरी करने के बाद, अपने कनेक्टर की समीक्षा का अनुरोध करने के लिए, यहां दिए गए बटन पर क्लिक करें:

Partner Connector को पब्लिश करना