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

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

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

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

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

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

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

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 प्रोजेक्ट पर लागू होती है जिनका इस्तेमाल, सर्वर-साइड लाइब्रेरी के तौर पर किया जा रहा है. इस लैटेंसी के बिना, jQuery जैसी क्लाइंट-साइड JavaScript लाइब्रेरी का इस्तेमाल किया जा सकता है.

एडिटर ऐड-ऑन इस्तेमाल करने के सबसे सही तरीके

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

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

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

अनुमति देने के अलग-अलग मोड में पूरी तरह से जांच करना

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