Google Workspace ऐड-ऑन के लिए ट्रिगर

Apps Script ट्रिगर की मदद से, किसी स्क्रिप्ट फ़ंक्शन (ट्रिगर फ़ंक्शन) को तब चलाया जा सकता है, जब कोई तय किया गया इवेंट होता है. सिर्फ़ कुछ इवेंट की वजह से ट्रिगर चालू हो सकते हैं. साथ ही, हर Google Workspace ऐप्लिकेशन में अलग-अलग इवेंट काम करते हैं.

ट्रिगर चालू होने पर, एक इवेंट ऑब्जेक्ट बनाया जाता है. इस JSON स्ट्रक्चर में, हुई घटना के बारे में जानकारी होती है. इवेंट ऑब्जेक्ट स्ट्रक्चर में मौजूद जानकारी को ट्रिगर टाइप के हिसाब से अलग-अलग तरीके से व्यवस्थित किया जाता है.

इवेंट ऑब्जेक्ट बनने के बाद, Apps Script इसे ट्रिगर फ़ंक्शन में पैरामीटर के तौर पर पास करता है. ट्रिगर फ़ंक्शन एक कॉलबैक फ़ंक्शन होता है. इसे आपको खुद लागू करना होगा, ताकि इवेंट का जवाब देने के लिए ज़रूरी कार्रवाइयां की जा सकें. उदाहरण के लिए, Gmail की सुविधाओं को बढ़ाने वाले Google Workspace ऐड-ऑन में, ऐसा ट्रिगर तय किया जा सकता है जो उपयोगकर्ता के मैसेज थ्रेड खोलने पर नया कार्ड इंटरफ़ेस बनाता है. इस मामले में, कॉन्टेक्स्ट के हिसाब से कॉलबैक फ़ंक्शन लागू किया जाता है. इससे इवेंट ऑब्जेक्ट में पास किए गए डेटा का इस्तेमाल करके, नए यूज़र इंटरफ़ेस (यूआई) वाले कार्ड बनाए जाते हैं.

इस पेज पर, Google Workspace ऐड-ऑन प्रोजेक्ट में ट्रिगर इस्तेमाल करने के बारे में दिशा-निर्देश दिए गए हैं.

मेनिफ़ेस्ट ट्रिगर

Editor ऐड-ऑन के उलट, Google Workspace ऐड-ऑन फ़िलहाल Apps Script के सिंपल ट्रिगर का इस्तेमाल नहीं कर सकते. इसके बजाय, वे Google Workspace ऐड-ऑन के लिए खास तौर पर डिज़ाइन किए गए ट्रिगर का इस्तेमाल करते हैं: मेनिफ़ेस्ट ट्रिगर.

मेनिफ़ेस्ट ट्रिगर, Google Workspace ऐड-ऑन के मेनिफ़ेस्ट में पूरी तरह से तय किए जाते हैं. मेनिफ़ेस्ट ट्रिगर के उदाहरणों में ये शामिल हैं:

• होम पेज ट्रिगर, जो ऐड-ऑन का होम पेज बनाते और दिखाते हैं.
• Calendar eventOpen ट्रिगर, जो Calendar इवेंट खोले जाने पर नया कार्ड दिखाते हैं या अन्य कार्रवाइयां करते हैं.
• Calendar eventUpdate ट्रिगर, जब कोई उपयोगकर्ता Calendar इवेंट में बदलाव करके उसे सेव करता है, तब ये ट्रिगर एक नया कार्ड दिखाते हैं या अन्य कार्रवाइयां करते हैं.
• Drive onItemsSelected ट्रिगर, जब कोई उपयोगकर्ता Drive में एक या उससे ज़्यादा फ़ाइलें या फ़ोल्डर चुनता है, तब ये ट्रिगर एक नया कार्ड दिखाते हैं या अन्य कार्रवाइयां करते हैं.
• Gmail में ईमेल लिखने की सुविधा को ट्रिगर करने वाले ऐड-ऑन, जो उपयोगकर्ता के Gmail में ईमेल लिखने की विंडो में ऐड-ऑन खोलने पर ऐड-ऑन कार्ड दिखाते हैं.
• Gmail के कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाली सुविधाएं. जब उपयोगकर्ता Gmail मैसेज खोलता है, तब ये सुविधाएं नया कार्ड दिखाती हैं या अन्य कार्रवाइयां करती हैं.
• Editor onFileScopeGranted ट्रिगर, उपयोगकर्ताओं को नया कार्ड दिखाते हैं. ऐसा तब होता है, जब उपयोगकर्ता मौजूदा Editor दस्तावेज़ में drive.file OAuth स्कोप के लिए अनुमति देते हैं.

ऊपर दी गई सूची में, सिर्फ़ होम पेज के ट्रिगर कॉन्टेक्स्ट के हिसाब से नहीं होते. बाकी सभी ट्रिगर, कॉन्टेक्स्ट के हिसाब से होते हैं. मेनिफ़ेस्ट ट्रिगर की परिभाषाओं के बारे में ज़्यादा जानने के लिए, मेनिफ़ेस्ट देखें.

मेनिफ़ेस्ट ट्रिगर के अलावा, Google Workspace ऐड-ऑन, Apps Script के इंस्टॉल किए जा सकने वाले ट्रिगर का भी इस्तेमाल कर सकते हैं.

पाबंदियां

मेनिफ़ेस्ट ट्रिगर के इस्तेमाल पर कुछ पाबंदियां लागू होती हैं.

• इन ट्रिगर का इस्तेमाल सिर्फ़ Google Workspace ऐड-ऑन प्रोजेक्ट में किया जाता है. इनका इस्तेमाल किसी अन्य ऐप्लिकेशन में नहीं किया जा सकता.
• इन्हें ऐड-ऑन के मेनिफ़ेस्ट में तय किया जाता है, न कि इसके कोड में. इसलिए, इन ट्रिगर को बनाने या उनमें बदलाव करने के लिए, Apps Script की Script सेवा का इस्तेमाल नहीं किया जा सकता.
• फ़िलहाल, Gmail के कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाली सुविधा में सिर्फ़ unconditional शर्त हो सकती है. इसका मतलब है कि कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाली सुविधा, हर ईमेल मैसेज के लिए काम करती है. भले ही, ईमेल का कॉन्टेंट कुछ भी हो.
• हर ऐड-ऑन में, हर टाइप का सिर्फ़ एक ट्रिगर हो सकता है. यह ट्रिगर, हर उपयोगकर्ता और हर दस्तावेज़ के लिए होता है.