नया Google Workspace ऐड-ऑन बनाने के लिए, इस सामान्य सेटिंग का पालन करें प्रक्रिया:
- अपने ऐड-ऑन के प्रोजेक्ट सेट अप करें और कोई मालिक चुनें और सहयोगी.
- यह तय करें कि आपका ऐड-ऑन कैसा दिखे और कैसे काम करे.
- ऐड-ऑन का प्रोजेक्ट मेनिफ़ेस्ट कॉन्फ़िगर करें या डिप्लॉयमेंट संसाधन का इस्तेमाल किया जा सकता है.
- ऐड-ऑन कैसा दिखेगा, यह तय करने के लिए कोड लिखें और व्यवहार.
- अपने ऐड-ऑन के OAuth दायरों की पुष्टि करें.
- ऐड-ऑन को होस्ट ऐप्लिकेशन तो वह फैला भी देती है.
- ऐड-ऑन पब्लिश करें.
अपने ऐड-ऑन के प्रोजेक्ट सेट अप करें. साथ ही, मालिक और सहयोगी चुनें
अगर आपने Apps Script में ऐड-ऑन बनाया है, आपको Apps Script प्रोजेक्ट और Google Cloud प्रोजेक्ट, दोनों बनाने होंगे. अगर आपने ऐड-ऑन को इनमें से किसी दूसरी भाषा में बनाया है Apps Script के साथ, आपको सिर्फ़ Google Cloud प्रोजेक्ट बनाना होगा.
ऐड-ऑन डेवलपमेंट शुरू करने से पहले, कोई एक विकल्प चुनें उपयोगकर्ता खाते से प्रोजेक्ट का मालिकाना हक लिया जा सकता है. साथ ही, यह तय किया जा सकता है कि कौनसे दूसरे खाते सहयोगी. प्रोजेक्ट का मालिक, प्रोजेक्ट फ़ाइलें बनाता और उन्हें मैनेज करता है साथ ही, कोडिंग और टेस्टिंग में मिलकर काम करने वाले लोगों की मदद कर सकते हैं.
Apps Script प्रोजेक्ट
ऐड-ऑन की Apps स्क्रिप्ट बनाई जा सकती है किसी ताकि कोई सिर्फ़ एक खाते का मालिकाना हक आपके पास हो. ऐड-ऑन इंस्टॉल किया जा रहा है शेयर की गई ड्राइव में मौजूद स्क्रिप्ट फ़ाइल से यह पक्का होता है कि एक से ज़्यादा सहयोगियों के पास स्क्रिप्ट प्रोजेक्ट.
ऐड-ऑन पब्लिश करने पर, एक उपयोगकर्ता खाता काम करता है प्रकाशक के तौर पर. पब्लिश करने वाले खाते के पास, स्क्रिप्ट में बदलाव करने का ऐक्सेस होना चाहिए लेकिन उसका मालिक होना ज़रूरी नहीं है.
Apps Script प्रोजेक्ट बनाने के लिए, स्क्रिप्ट प्रोजेक्ट देखें.
Google Cloud प्रोजेक्ट
हम सुझाव देते हैं कि आप ऐड-ऑन Cloud प्रोजेक्ट. इससे यह पक्का करने में मदद मिलती है कि आपकी टीम का कोई व्यक्ति क्लाउड सेटिंग पर जाएं.
Google Cloud प्रोजेक्ट बनाने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.
ऐड-ऑन के दिखने और काम करने का तरीका तय करें
तय करें कि आपको ऐड-ऑन कैसा और कैसा दिखना चाहिए उसे बनाने से पहले उसे सही तरह से काम करना चाहिए. देखें कि ऐड-ऑन को समाधान देने की कोशिश करनी चाहिए. शुरू होने की तारीख जिसे पहले काम करने के लिए एक आसान से डिज़ाइन किया गया है और फिर उसमें और सुधार जोड़े गए हैं.
Google Workspace ऐड-ऑन की स्टाइल गाइड देखें ऐड-ऑन उपयोगकर्ता को डिज़ाइन करने के दिशा-निर्देश देखें अनुभव.
ऐड-ऑन प्रोजेक्ट मेनिफ़ेस्ट कॉन्फ़िगर करें
Apps Script प्रोजेक्ट में, प्रोजेक्ट मेनिफ़ेस्ट एक खास JSON है फ़ाइल से लिए जाते हैं. यह प्रोजेक्ट के बारे में कई तरह की जानकारी देता है, जैसे कि इसकी लाइब्रेरी निर्भरता. Google Workspace ऐड-ऑन के लिए, मेनिफ़ेस्ट में बुनियादी वह जानकारी जो होस्ट ऐप्लिकेशन को दिखाने की ज़रूरत होती है ऐड-ऑन सही तरीके से काम करता है.
अपनी रिपोर्ट कॉन्फ़िगर करने का तरीका जानने के लिए, मेनिफ़ेस्ट देखें का मेनिफ़ेस्ट फ़ाइल खोलें.
ऐड-ऑन में कोड और सुविधाएं जोड़ने के बाद, ज़रूरी ऐड-ऑन बनाने के लिए मेनिफ़ेस्ट और व्यवहार.
ऐड-ऑन को कोड करें
आपको इसके लिए एक कार्ड-आधारित इंटरफ़ेस लागू करना होगा ऐड-ऑन. Apps Script की कार्ड सेवा या अगर आपको किसी दूसरी कोड भाषा में लिखना है, तो वापस करें JSON को सही तरीके से फ़ॉर्मैट किया गया हो, ताकि इंटरफ़ेस को कार्ड के तौर पर रेंडर किया जा सके.
अगर आपको किसी ट्रिगर को फ़ंक्शन में बताया गया है में से एक है. अगर आपके यह ऐड-ऑन, Google से बाहर की किसी तीसरे पक्ष की सेवा से कनेक्ट होता है तो आपको उस संगठन के लिए OAuth को कॉन्फ़िगर करना होगा सेवा में भी ट्रांसफ़र हुई है.
कार्ड बनाना
ऐड-ऑन यूज़र इंटरफ़ेस बनाने के लिए
Card
ऑब्जेक्ट और उन्हें भरना
विजेट. इसमें दिए गए ट्रिगर फ़ंक्शन
आपकी मेनिफ़ेस्ट फ़ाइल में दिए गए
Card
ऑब्जेक्ट या इसका कलेक्शन
Card
ऑब्जेक्ट जो दिखाते हैं कि
अलग-अलग 'पेज' में रखा गया है. आपका
ऐड-ऑन की मदद से नए कार्ड बनाए और दिखाए भी जा सकते हैं
उपयोगकर्ता की कार्रवाइयों पर प्रतिक्रिया.
Apps Script में, कार्ड बनाने के लिए
CardBuilder
क्लास. हर
कार्ड के लिए CardHeader
की ज़रूरत है
और एक या उससे ज़्यादा
CardSections
. आपको ऐसा करना चाहिए
हर कार्ड सेक्शन को उन अलग-अलग विजेट से भरें जो
ऐड-ऑन इंटरफ़ेस. इंटरैक्शन
विजेट,
आम तौर पर, कार्रवाइयों से जुड़ा होता है, ताकि
इंटरैक्शन के बारे में ज़्यादा जानकारी शामिल होती है.
इसके बाद,
CardBuilder
, आपको कॉल करना होगा
CardBuilder.build()
संबंधित Card
ऑब्जेक्ट बनाने के लिए.
आप पहले से मौजूद अन्य Apps Script फ़ाइल का इस्तेमाल कर सकते हैं
सेवाओं जैसे कि
वापस पाने के लिए, CalendarApp
आपके बनाए ऐड-ऑन कार्ड में दिखने वाली जानकारी.
Google से बाहर की सेवाओं से फ़ेच किए गए डेटा का इस्तेमाल किया जा सकता है.
अगर आपके Google Workspace ऐड-ऑन को Google से बाहर के ऐसे एपीआई का ऐक्सेस चाहिए जिनके लिए OAuth की ज़रूरत होती है, तो को उस सेवा को कॉन्फ़िगर और उससे कनेक्ट करना होगा— Google से बाहर की सेवाओं के बारे में जानकारी देने वाली गाइड देखें.
निर्माण आदेश
कार्ड बनाते समय, आपको टॉप अप से बनाना होगा. इसका मतलब है कि आपको हर तरह के विज्ञापन निर्माण क्रम:
- विजेट बनाएं.
- विजेट को कार्ड सेक्शन में जोड़ें.
- यह तब तक दोहराएं, जब तक कार्ड सेक्शन में सभी विजेट उपलब्ध न हो जाएं.
- कार्ड में कार्ड सेक्शन जोड़ें.
ऐसा करना ज़रूरी है, क्योंकि कार्ड या कार्ड सेक्शन में कोई विजेट जोड़ने पर उस विजेट की कॉपी जोड़ रहे हैं. विजेट में आपके किए गए कोई भी बदलाव ऑब्जेक्ट जोड़ने के बाद, फ़ाइनल कार्ड में नहीं दिखता.
यूनिवर्सल कार्रवाइयां
यूनिवर्सल ऐक्शन का इस्तेमाल किया जा सकता है का इस्तेमाल, कॉन्टेक्स्ट के हिसाब से अलग-अलग तरह से किया जा सकता है. यूनिवर्सल ऐक्शन, मेन्यू आइटम होते हैं ऐड-ऑन यूज़र इंटरफ़ेस (यूआई) में उपलब्ध होता है, भले ही वह कोई भी कार्ड हो दिखाया जाएगा. सभी तय यूनिवर्सल कार्रवाइयां, हमेशा इसमें दिखती हैं ऐड-ऑन का कार्ड मेन्यू.
ज़्यादा जानकारी के लिए, Universal कार्रवाइयां देखें विवरण.
ऐड-ऑन OAuth के दायरे की पुष्टि करें
स्कोप से तय होता है कि ऐड-ऑन को उपयोगकर्ता की ओर से लेने की अनुमति है. यह है ऐड-ऑन के लिए सिर्फ़ उन कार्रवाइयों के दायरे रखने का सबसे सही तरीका के क्रम में होना चाहिए, इसके अलावा और कुछ नहीं होना चाहिए.
ऐड-ऑन प्रोजेक्ट में, विज्ञापन दिखने की फ़्रीक्वेंसी सेट करने के लिए, का ऐड-ऑन नहीं है स्कोप का इस्तेमाल करके यह पक्का किया जा सकता है कि ऐड-ऑन दायरे के कम से कम अनुमति वाले सेट का इस्तेमाल करता है किया जा सकता है. आपका ऐड-ऑन किन दायरों का इस्तेमाल करता है, यह तय करना ऐड-ऑन मेनिफ़ेस्ट में बदल दिया जाएगा.
ज़्यादा जानकारी के लिए, दायरे देखें.
ऐड-ऑन का परीक्षण करें
आप पहले इंस्टॉल किए गए ऐड-ऑन की जांच करके, अनपब्लिश किए गए ऐड-ऑन. ऐड-ऑन को इंस्टॉल करने और अनुमति देने के बाद, उसका इस्तेमाल किया जा सकता है और होस्ट ऐप्लिकेशन में इसके दिखने और व्यवहार की जांच करने के लिए किया जा सकता है. विस्तार. आपको पुष्टि करनी होगी कि ऐड-ऑन इस तरह काम करता है का इस्तेमाल, कॉन्टेक्स्ट और उपयोगकर्ता की कार्रवाइयों के लिए किया जा सकता है.
ज़्यादा जानकारी के लिए, Google Workspace ऐड-ऑन की जांच करना लेख पढ़ें.
ऐड-ऑन पब्लिश करें
अपना ऐड-ऑन प्रकाशित करने से यह दूसरों के लिए उपलब्ध हो जाता है, सार्वजनिक रूप से या सिर्फ़ आपके डोमेन के उपयोगकर्ता. पब्लिश करने से पहले प्रोसेस के लिए, पब्लिकेशन की खास जानकारी ज़रूर देखें. पब्लिकेशन एक मुश्किल प्रोसेस है, तैयारी और उसे पूरा करने में लगने वाला समय.
Google Workspace ऐड-ऑन, Google Workspace Marketplace पर पब्लिश किए गए हैं. सार्वजनिक तौर पर उपलब्ध ऐड-ऑन को पहले ऐप्लिकेशन की समीक्षा पूरी करनी होगी वे पब्लिश हो जाते हैं.
इनके लिए, Google Workspace ऐड-ऑन पब्लिश करना लेख पढ़ें देखें.