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

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

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

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

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

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

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

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

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

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

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

पाबंदियां

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

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