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

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

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

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

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

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

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

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

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