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

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

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

urlFetchWhitelist

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

oauthScopes

1. मेनिफ़ेस्ट में साफ़ तौर पर OAuth स्कोप सेट करें. साफ़ तौर पर OAuth के स्कोप वाले कनेक्टर अस्वीकार कर दिए जाएंगे.

कनेक्टर

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

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

पार्टनर कनेक्टर को पब्लिश करें