सबसे सही तरीके

ऐड-ऑन के डिज़ाइन के लिए, यहां दी गई गाइडलाइन का पालन करके, अपने उपयोगकर्ताओं के लिए बेहतर अनुभव उपलब्ध कराएं.

सबसे सही तरीके

हमारा सुझाव है कि आप अपने सभी ऐड-ऑन के लिए, यहां दिए गए सबसे सही तरीकों का इस्तेमाल करें.

ऐड-ऑन बनाना शुरू करने से पहले, उसके मालिकाना हक के बारे में तय करना

ऐड-ऑन, Apps Script प्रोजेक्ट के ज़रिए तय किए जाते हैं. इनका मालिकाना हक किसी खास खाते के पास होना चाहिए. इसके अलावा, इन्हें शेयर की गई डिस्क में रखा जाना चाहिए. ऐड-ऑन के लिए कोडिंग करने से पहले, यह तय करें कि प्रोजेक्ट का मालिकाना हक किस खाते के पास होना चाहिए और कौनसे खाते को पब्लिशर के तौर पर इस्तेमाल किया जाना चाहिए. यह भी तय करें कि किन खातों को सहयोगी के तौर पर इस्तेमाल किया जाना है. साथ ही, पक्का करें कि उन खातों के पास स्क्रिप्ट प्रोजेक्ट और उससे जुड़े Google Cloud प्रोजेक्ट का ऐक्सेस हो.

ध्यान दें: ऐड-ऑन के मालिकाना हक की योजना बनाना ज़रूरी है. अगर ऐड-ऑन का मालिक आपके संगठन को छोड़ देता है, तो आपको यह पक्का करना होगा कि मालिकाना हक ट्रांसफ़र कर दिया गया हो. ऐसा न करने पर, आपके पास ऐड-ऑन को अपडेट और मैनेज करने की सुविधा नहीं रहेगी. इसलिए, अपने संगठन के ऐड-ऑन का मालिकाना हक पाने और उन्हें पब्लिश करने के लिए, खास तौर पर संगठन का खाता बनाना सबसे अच्छा हो सकता है. स्क्रिप्ट प्रोजेक्ट के मालिक के तौर पर, शेयर की गई ड्राइव का भी इस्तेमाल किया जा सकता है. हालांकि, ऐड-ऑन के पब्लिशर के तौर पर किसी खास खाते का इस्तेमाल करना ज़रूरी है.

Google Workspace को बेहतर बनाएं, न कि उसकी नकल करें

ऐड-ऑन, Google Workspace के उन ऐप्लिकेशन के लिए नई सुविधाएं उपलब्ध कराने के लिए बनाए जाते हैं जिन्हें वे बेहतर बनाते हैं. इसके अलावा, इनका इस्तेमाल मुश्किल टास्क को ऑटोमेट करने के लिए भी किया जाता है. ऐसे ऐड-ऑन जो सिर्फ़ ऐप्लिकेशन में पहले से मौजूद सुविधाओं की नकल करते हैं या जो किसी वर्कफ़्लो में कोई खास सुधार नहीं करते हैं, उन्हें पब्लिश करने के लिए ऐड-ऑन की समीक्षा में पास होने की संभावना कम होती है.

स्कोप को सीमित रखें

अपने स्कोप को साफ़ तौर पर तय करते समय, हमेशा स्कोप का सबसे कम अनुमति वाला सेट चुनें. उदाहरण के लिए, अगर आपके ऐड-ऑन को सिर्फ़ पढ़ने का ऐक्सेस चाहिए, तो https://www.googleapis.com/auth/calendar स्कोप के साथ, उपयोगकर्ता के कैलेंडर का पूरा ऐक्सेस पाने का अनुरोध न करें. सिर्फ़ पढ़ने के ऐक्सेस के लिए, https://www.googleapis.com/auth/calendar.readonly स्कोप का इस्तेमाल करें.

लाइब्रेरी पर बहुत ज़्यादा निर्भर रहने से बचें

Apps Script लाइब्रेरी का इस्तेमाल करने से, आपका ऐड-ऑन, Apps Script के सभी कोड को एक स्क्रिप्ट प्रोजेक्ट में शामिल करने पर मिलने वाली परफ़ॉर्मेंस से कम परफ़ॉर्म कर सकता है. हालांकि, Apps Script लाइब्रेरी, ऐड-ऑन में काम करती हैं. हालांकि, इनका इस्तेमाल करने पर, आपको परफ़ॉर्मेंस में कमी दिख सकती है. अपने प्रोजेक्ट में गैर-ज़रूरी लाइब्रेरी शामिल करने से बचें. साथ ही, इस बात पर विचार करें कि ऐड-ऑन की इन पर निर्भरता को कैसे कम किया जा सकता है.

ऊपर बताई गई लेटेन्सी की समस्या, सिर्फ़ सर्वर-साइड लाइब्रेरी के तौर पर इस्तेमाल किए जा रहे Apps Script प्रोजेक्ट पर लागू होती है. क्लाइंट-साइड JavaScript लाइब्रेरी, जैसे कि jQuery का इस्तेमाल बिना किसी लेटेन्सी के किया जा सकता है.

एडिटर ऐड-ऑन के सबसे सही तरीके

यहां दिए गए सबसे सही तरीके, सिर्फ़ एडिटर ऐड-ऑन पर लागू होते हैं.

इंटरफ़ेस एचटीएमएल और क्लाइंट-साइड JavaScript को उनकी स्क्रिप्ट फ़ाइलों में रखना

Apps Script प्रोजेक्ट में, एक से ज़्यादा स्क्रिप्ट फ़ाइलें बनाई जा सकती हैं. अगर ऐड-ऑन के साइडबार और डायलॉग को तय करने वाले एचटीएमएल और JavaScript को, उनसे जुड़ी स्क्रिप्ट फ़ाइलों में रखा जाए, तो मुश्किल ऐड-ऑन को मैनेज करना आसान हो जाता है.

अलग-अलग अनुमति वाले मोड में अच्छी तरह से जांच करना

अपने ऐड-ऑन की जांच करते समय, अलग-अलग फ़ाइलों और अनुमति की अलग-अलग स्थितियों वाले कॉन्फ़िगरेशन आज़माएं.