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

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

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

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

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

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

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

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

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

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

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

पाबंदियां

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

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