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