ऐड-ऑन के डिज़ाइन के लिए इन गाइड का पालन करके, अपने उपयोगकर्ताओं के अनुभव को बेहतर बनाएं.
सबसे सही तरीके
हमारा सुझाव है कि आप अपने सभी ऐड-ऑन के लिए, यहां दिए गए सबसे सही तरीकों का इस्तेमाल करें.
शुरू करने से पहले, ऐड-ऑन के मालिकाना हक का पता लगाना
ऐड-ऑन, 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 प्रोजेक्ट पर लागू होती है जिनका इस्तेमाल, सर्वर-साइड लाइब्रेरी के तौर पर किया जा रहा है. इस इंतज़ार के बिना, jQuery जैसी क्लाइंट-साइड JavaScript लाइब्रेरी का इस्तेमाल किया जा सकता है.
एडिटर ऐड-ऑन इस्तेमाल करने के सबसे सही तरीके
यहां दिए गए सबसे सही तरीके सिर्फ़ Editor के ऐड-ऑन पर लागू होते हैं.
इंटरफ़ेस एचटीएमएल और क्लाइंट-साइड JavaScript को उनकी स्क्रिप्ट फ़ाइलों में रखें
Apps Script प्रोजेक्ट में कई स्क्रिप्ट फ़ाइलें बनाई जा सकती हैं. किसी जटिल ऐड-ऑन को मैनेज करना आसान हो जाता है, अगर आपने ऐड-ऑन के साइडबार और डायलॉग को तय करने वाले एचटीएमएल और JavaScript को, उनके लिए बनाई गई स्क्रिप्ट फ़ाइलों में रखा है.
अनुमति देने के अलग-अलग मोड में पूरी तरह से जांच करें
अपने ऐड-ऑन की जांच करते समय, ऐसे कॉन्फ़िगरेशन आज़माना न भूलें जिनमें अलग-अलग फ़ाइलें और अनुमति की अलग-अलग स्थितियां हों.