Apps Script ट्रिगर से, तय किए गए स्क्रिप्ट फ़ंक्शन (ट्रिगर फ़ंक्शन) को ट्रिगर किया जाता है, ताकि कोई खास इवेंट होने पर वे ट्रिगर हो जाएं. सिर्फ़ कुछ खास इवेंट की वजह से ही ट्रिगर सक्रिय हो सकते हैं. साथ ही, हर Google Workspace ऐप्लिकेशन पर इवेंट के अलग सेट काम करते हैं.
ट्रिगर के सक्रिय होने पर, एक इवेंट ऑब्जेक्ट बन जाता है. इस JSON स्ट्रक्चर में होने वाले इवेंट की जानकारी शामिल है. इवेंट ऑब्जेक्ट स्ट्रक्चर में जानकारी को ट्रिगर टाइप के आधार पर अलग-अलग तरीके से व्यवस्थित किया जाता है.
इवेंट ऑब्जेक्ट बनने के बाद, Apps Script इसे ट्रिगर फ़ंक्शन में एक पैरामीटर के तौर पर पास करता है. ट्रिगर फ़ंक्शन एक कॉलबैक फ़ंक्शन है, जिसे इवेंट का जवाब देने के लिए सही कार्रवाइयां करने के लिए, आपको खुद ही लागू करना होगा. उदाहरण के लिए, Gmail के साथ काम करने वाले Google Workspace ऐड-ऑन में, एक ट्रिगर तय किया जा सकता है. यह ट्रिगर, उपयोगकर्ता के मैसेज थ्रेड को खोलने पर एक नया कार्ड इंटरफ़ेस बनाता है. इस मामले में, इवेंट ऑब्जेक्ट में पास किए गए डेटा का इस्तेमाल करके, नए यूज़र इंटरफ़ेस (यूआई) के हिसाब से कार्ड बनाने के लिए, कॉन्टेक्स्ट के हिसाब से कॉलबैक फ़ंक्शन लागू किया जाता है.
इस पेज पर, Google Workspace ऐड-ऑन प्रोजेक्ट में ट्रिगर का इस्तेमाल करने के बारे में दिशा-निर्देश दिए गए हैं.
मेनिफ़ेस्ट ट्रिगर
Google Workspace ऐड-ऑन, फ़िलहाल Apps Script के सिंपल ट्रिगर का इस्तेमाल नहीं कर सकते. इसके बजाय, वे खास तौर पर Google Workspace ऐड-ऑन के लिए बनाए गए ट्रिगर का इस्तेमाल करते हैं: मेनिफ़ेस्ट ट्रिगर.
मेनिफ़ेस्ट ट्रिगर के बारे में पूरी तरह से Google Workspace ऐड-ऑन के मेनिफ़ेस्ट में बताया गया है. मेनिफ़ेस्ट ट्रिगर के उदाहरणों में ये चीज़ें शामिल हैं:
- होम पेज ट्रिगर, जो ऐड-ऑन होम पेज को बनाते और दिखाते हैं.
- कैलेंडर इवेंट खोलने वाले ट्रिगर, जो एक नया कार्ड दिखाते हैं या कैलेंडर इवेंट खोले जाने पर दूसरी कार्रवाइयां करते हैं.
- Calendar eventअपडेट ट्रिगर होते हैं, जो उस समय नया कार्ड दिखाते हैं या जब कोई उपयोगकर्ता कैलेंडर इवेंट में बदलाव करता है और उसे सेव करता है, तो दूसरी कार्रवाइयां करता है.
- आइटम चुने गए आइटम पर Drive की सुविधा चालू करने पर, जब कोई उपयोगकर्ता Drive में एक या एक से ज़्यादा फ़ाइलें या फ़ोल्डर चुनता है, तो नया कार्ड दिखता है या अन्य कार्रवाइयां करता है.
- Gmail में लिखने के ट्रिगर होते हैं. ये तब एक ऐड-ऑन कार्ड दिखाते हैं, जब उपयोगकर्ता, Gmail की ईमेल लिखने वाली विंडो में ऐड-ऑन खोलता है.
- Gmail के हिसाब से ट्रिगर होने वाले ऐसे ट्रिगर जो उपयोगकर्ता के Gmail मैसेज खोलने पर नया कार्ड दिखाते हैं या अन्य कार्रवाइयां करते हैं.
- Editor onFileScopeअनुमति वाले ट्रिगर जो एक नया कार्ड दिखाते हैं. ऐसा तब होता है, जब उपयोगकर्ता
मौजूदा Editor दस्तावेज़ में
drive.fileOAuth स्कोप के लिए अनुमति देते हैं.
ऊपर दी गई सूची में, सिर्फ़ होम पेज ट्रिगर काम के नहीं हैं. बाकी के ट्रिगर संदर्भ के हिसाब से हैं. मेनिफ़ेस्ट ट्रिगर की परिभाषाओं के बारे में ज़्यादा जानकारी पाने के लिए, मेनिफ़ेस्ट देखें.
मेनिफ़ेस्ट ट्रिगर के अलावा, Google Workspace ऐड-ऑन के लिए Apps Script इंस्टॉल किए जा सकने वाले ट्रिगर का भी इस्तेमाल किया जा सकता है.
पाबंदियां
मेनिफ़ेस्ट ट्रिगर के इस्तेमाल पर कुछ पाबंदियां होती हैं.
- इन ट्रिगर का इस्तेमाल सिर्फ़ Google Workspace ऐड-ऑन प्रोजेक्ट में किया जाता है. इनके किसी दूसरे ऐप्लिकेशन में काम नहीं करता है.
- ये ट्रिगर, ऐड-ऑन मेनिफ़ेस्ट में बताए गए होते हैं, न कि उनके कोड में. इसलिए, इन ट्रिगर को बनाने या इनमें बदलाव करने के लिए, Apps Script
Scriptसेवा का इस्तेमाल नहीं किया जा सकता. - फ़िलहाल, Gmail कॉन्टेक्स्ट के हिसाब से ट्रिगर में सिर्फ़
unconditionalशर्तें हो सकती हैं. इसका मतलब है कि संदर्भ के हिसाब से ट्रिगर हर ईमेल मैसेज के लिए सक्रिय होते हैं, चाहे कॉन्टेंट कुछ भी हो. - हर ऐड-ऑन में, हर दस्तावेज़ के लिए, हर तरह का सिर्फ़ एक ट्रिगर हो सकता है.