Action ऑब्जेक्ट की मदद से, Google Workspace ऐड-ऑन में इंटरैक्टिव
व्यवहार बनाया जा सकता है. इनसे यह तय होता है कि ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) में, किसी विजेट (उदाहरण के लिए, बटन) के साथ उपयोगकर्ता के इंटरैक्ट करने पर क्या होगा.
विजेट हैंडलर फ़ंक्शन का इस्तेमाल करके, किसी कार्रवाई को दिए गए विजेट से जोड़ा जाता है. यह फ़ंक्शन, कार्रवाई को ट्रिगर करने वाली शर्त भी तय करता है. ट्रिगर होने पर, कार्रवाई एक तय किए गए कॉलबैक फ़ंक्शन को लागू करती है. कॉलबैक फ़ंक्शन को एक इवेंट ऑब्जेक्ट पास किया जाता है. इसमें उपयोगकर्ता के क्लाइंट-साइड इंटरैक्शन के बारे में जानकारी होती है. आपको कॉलबैक फ़ंक्शन लागू करना होगा. साथ ही, उसे एक खास रिस्पॉन्स ऑब्जेक्ट दिखाना होगा.
उदाहरण के लिए, मान लें कि आपको ऐसा बटन चाहिए जिस पर क्लिक करने पर, नया कार्ड बन जाए और दिखने लगे. इसके लिए, आपको एक नया बटन विजेट बनाना होगा. साथ ही, कार्ड बनाने की सुविधा Action सेट करने के लिए, बटन विजेट हैंडलर फ़ंक्शन setOnClickAction(action) का इस्तेमाल करना होगा. आपने जिस Action को तय किया है वह Apps Script का एक कॉलबैक फ़ंक्शन है. यह बटन पर क्लिक करने पर काम करता है. इस मामले में, आपको अपनी पसंद का कार्ड बनाने के लिए कॉलबैक फ़ंक्शन लागू करना होगा. साथ ही, ActionResponse ऑब्जेक्ट दिखाना होगा. जवाब देने वाला ऑब्जेक्ट, ऐड-ऑन को यह बताता है कि कार्ड को उस कॉलबैक फ़ंक्शन के ज़रिए दिखाया जाए जिसे बनाया गया है.
इस पेज पर, Gmail के लिए खास तौर पर उपलब्ध विजेट की कार्रवाइयों के बारे में बताया गया है. इन्हें अपने ऐड-ऑन में शामिल किया जा सकता है.
Gmail इंटरैक्शन
Gmail की सुविधाओं को बढ़ाने वाले Google Workspace ऐड-ऑन में, Gmail के लिए खास तौर पर तैयार की गई विजेट कार्रवाई शामिल हो सकती है. इससे ड्राफ़्ट मैसेज लिखे जा सकते हैं. इस कार्रवाई के लिए, इससे जुड़े कॉलबैक फ़ंक्शन को एक खास रिस्पॉन्स ऑब्जेक्ट दिखाना होगा:
| कार्रवाई करने की कोशिश की गई | कॉलबैक फ़ंक्शन को यह वैल्यू दिखानी चाहिए |
|---|---|
| ड्राफ़्ट मैसेज लिखना | ComposeActionResponse |
विजेट की इन कार्रवाइयों और रिस्पॉन्स ऑब्जेक्ट का इस्तेमाल करने के लिए, Google Workspace ऐड-ऑन के मेनिफ़ेस्ट में https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope शामिल होना चाहिए.
मैसेज लिखें
Gmail की सुविधाओं को बढ़ाने वाले ऐड-ऑन, एक ऐसा विजेट तय कर सकते हैं जिससे इंटरैक्ट करने पर, Gmail में ड्राफ़्ट मैसेज जनरेट होते हैं. ये नए मैसेज या जवाब हो सकते हैं. इसके लिए,ट्रिगर करने वाले विजेट को ऐसे कॉलबैक फ़ंक्शन से जोड़ें जो ComposeActionResponse ऑब्जेक्ट दिखाता है. जब कॉलबैक फ़ंक्शन का काम पूरा हो जाता है, तब Gmail इस जवाब ऑब्जेक्ट का इस्तेमाल करके, ड्राफ़्ट कंपोज़ विंडो को खोलता है और उसमें जानकारी भरता है.
ज़्यादा जानकारी और उदाहरण के लिए, ड्राफ़्ट मैसेज लिखना लेख पढ़ें.