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

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

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

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

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

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

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 को ऐसी स्क्रिप्ट फ़ाइलों में डाला जाता है जो ऐड-ऑन साइडबार और डायलॉग के लिए बनी हैं.

अनुमति देने के अलग-अलग मोड में जांच करें

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