ऐड-ऑन के डिज़ाइन के लिए, इन गाइड को पढ़कर अपने उपयोगकर्ताओं को बेहतर अनुभव दें.
सबसे सही तरीके
हमारा सुझाव है कि आप अपने बनाए गए सभी ऐड-ऑन के लिए, यहां दिए गए सबसे सही तरीकों का इस्तेमाल करें.
शुरू करने से पहले, ऐड-ऑन के मालिकाना हक की पुष्टि करना
ऐड-ऑन, Apps Script प्रोजेक्ट से तय होते हैं. इनका मालिकाना हक किसी खास खाते के पास होना चाहिए या इन्हें शेयर की गई ड्राइव में रखा जाना चाहिए. ऐड-ऑन को कोड करने से पहले, यह तय करें कि प्रोजेक्ट का मालिकाना हक किस खाते के पास होना चाहिए और कौन सा खाता पब्लिशर के तौर पर काम करेगा. यह भी तय करें कि किन खातों को साथ मिलकर काम करने वाले लोगों के तौर पर इस्तेमाल करना है. साथ ही, पक्का करें कि उन खातों के पास स्क्रिप्ट प्रोजेक्ट और उससे जुड़े Google Cloud प्रोजेक्ट का ऐक्सेस हो.
Google Workspace को बेहतर बनाएं, न कि उसे कॉपी करें
ऐड-ऑन का मकसद, Google Workspace के उन ऐप्लिकेशन को नई सुविधाएं देना है जिनके लिए उन्हें बनाया गया है. इसके अलावा, इनका इस्तेमाल मुश्किल टास्क को अपने-आप पूरा करने के लिए भी किया जाता है. ऐसे ऐड-ऑन पब्लिश करने के लिए, ऐड-ऑन की समीक्षा पास नहीं कर पाएंगे जो सिर्फ़ ऐप्लिकेशन में पहले से मौजूद फ़ंक्शन को दोहराते हैं या जो वर्कफ़्लो में कोई खास सुधार नहीं करते हैं.
स्कोप को सीमित रखें
अपने स्कोप को साफ़ तौर पर तय करते समय, हमेशा स्कोप का सबसे कम अनुमतियों वाला सेट चुनें. उदाहरण के लिए, अगर ऐड-ऑन को सिर्फ़ पढ़ने का ऐक्सेस चाहिए, तो उसे https://www.googleapis.com/auth/calendar स्कोप के साथ उपयोगकर्ता के Calendar का पूरा ऐक्सेस पाने का अनुरोध नहीं करना चाहिए. रीड ओनली ऐक्सेस के लिए, https://www.googleapis.com/auth/calendar.readonly स्कोप का इस्तेमाल करें.
लाइब्रेरी पर बहुत ज़्यादा भरोसा न करें
Apps Script लाइब्रेरी का इस्तेमाल करने से, आपका ऐड-ऑन ज़्यादा धीरे काम कर सकता है. ऐसा तब होता है, जब Apps Script का पूरा कोड किसी एक स्क्रिप्ट प्रोजेक्ट में शामिल हो. Apps Script लाइब्रेरी, ऐड-ऑन में काम करती हैं. हालांकि, इनका इस्तेमाल करने पर आपको परफ़ॉर्मेंस में गिरावट देखने को मिल सकती है. अपने प्रोजेक्ट में ग़ैर-ज़रूरी लाइब्रेरी शामिल न करें. साथ ही, इस बात पर विचार करें कि ऐड-ऑन को इन लाइब्रेरी पर कम से कम निर्भर कैसे रखा जाए.
ऊपर बताई गई लेटेन्सी, सिर्फ़ उन Apps Script प्रोजेक्ट पर लागू होती है जिनका इस्तेमाल सर्वर-साइड लाइब्रेरी के तौर पर किया जा रहा है. इस वजह से होने वाली देरी के बिना, jQuery जैसी क्लाइंट-साइड JavaScript लाइब्रेरी का इस्तेमाल किया जा सकता है.
एडिटर ऐड-ऑन इस्तेमाल करने के सबसे सही तरीके
यहां दिए गए सबसे सही तरीके, सिर्फ़ Editor ऐड-ऑन पर लागू होते हैं.
इंटरफ़ेस एचटीएमएल और क्लाइंट-साइड JavaScript को उनकी स्क्रिप्ट फ़ाइलों में रखें
Apps Script प्रोजेक्ट में कई स्क्रिप्ट फ़ाइलें बनाई जा सकती हैं. अगर ऐड-ऑन के साइडबार और डायलॉग बॉक्स को तय करने वाले एचटीएमएल और JavaScript को उनसे जुड़ी स्क्रिप्ट फ़ाइलों में रखा जाता है, तो कॉम्प्लेक्स ऐड-ऑन को मैनेज करना आसान हो जाता है.
पुष्टि करने के अलग-अलग मोड में अच्छी तरह से टेस्ट करें
अपने ऐड-ऑन की जांच करते समय, ऐसे कॉन्फ़िगरेशन आज़माएं जिनमें अलग-अलग फ़ाइलें और अनुमति की अलग-अलग स्थितियां हों.