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