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

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

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

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

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

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

Google Workspace ऐड-ऑन इस्तेमाल करने के सबसे सही तरीके

यहां दिए गए सबसे सही तरीके सिर्फ़ इन पर लागू होते हैं: Google Workspace ऐड-ऑन और उनका इस्तेमाल कार्ड सेवा के दायरे में आता है.

सिर्फ़ कुछ कार्ड का इस्तेमाल करें

अगर ऐड-ऑन बहुत ज़्यादा कार्ड का इस्तेमाल करता है, तो नेविगेशन कॉन्फ़िगरेशन तो उसे मैनेज करना मुश्किल और मुश्किल हो जाता है.

इसलिए, ज़रूरत से ज़्यादा कार्ड बनाने के लिए, जल्दबाज़ी न करें.

विजेट बनाने वाले फ़ंक्शन का इस्तेमाल करना

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

कार्ड को आसान रखना

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

गड़बड़ी वाले कार्ड का इस्तेमाल करना

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

टेस्ट और टेस्ट मैसेज लिखना

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

कार्रवाई कॉलबैक फ़ंक्शन का इस्तेमाल करते समय, आपको आम तौर पर एक रिस्पॉन्स ऑब्जेक्ट बनाना होगा. आप ताकि इस बात की पुष्टि हो सके कि जवाब सही ढंग से तैयार किए जा रहे हैं:

    Logger.log(response.printJson());

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

हर उस होस्ट ऐप्लिकेशन के लिए सही टेस्ट डेटा का इस्तेमाल करें जो ऐड-ऑन के दायरे में आता है. इसके लिए उदाहरण के लिए, अगर ऐड-ऑन से Gmail का इस्तेमाल किया जा सकता है, तो आपको कुछ टेस्ट ईमेल भेजने पड़ सकते हैं और उनका मैसेज आईडी सबमिट करें, ताकि आप यह पक्का कर सकें कि ऐड-ऑन जब मैसेज का कॉन्टेंट अलग हो, तो उसकी उम्मीद की जाती है. आपको किसी ईमेल पते से दिए गए मैसेज की सूची बनाने के लिए Gmail API User.messages.list करने का तरीका है या Apps Script की Gmail सेवा.

कैलेंडर कॉन्फ़्रेंसिंग के सबसे सही तरीके

अगर आपका ऐड-ऑन, तीसरे पक्ष के साथ इंटिग्रेट है, तो कैलेंडर कॉन्फ़्रेंसिंग में ये विकल्प शामिल हैं, तो इन अतिरिक्त सबसे सही तरीकों का पालन करें:

अपने onCreateFunction को हल्का रखें

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

कॉन्फ़्रेंस डेटा के लिए सही ConferenceData फ़ील्ड का इस्तेमाल करें

बनाने पर ConferenceData ऑब्जेक्ट हैं, तो उन्हें कॉन्फ़्रेंस के बारे में जानकारी के साथ दिखाया जा सकता है (ऐक्सेस कोड, फ़ोन नंबर, पिन, यूआरआई वगैरह). पक्का करें कि EntryPoint फ़ील्ड देखें. इस जानकारी को ConferenceData में न डालें नोट फ़ील्ड में जोड़ें.

Google Calendar इवेंट में कॉन्फ़्रेंसिंग की जानकारी न जोड़ें

ऐड-ऑन को बनाए गए तीसरे पक्ष की जानकारी जोड़ने की ज़रूरत नहीं है कॉन्फ़्रेंस के लिए इस्तेमाल किया जा सकता है. Google Calendar यह काम करता है: ज़रूरत पड़ने पर यह अपने-आप अपडेट हो जाएगा.