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, ड्राफ़्ट के तौर पर दिखने वाली विंडो को खोलने और पॉप्युलेट करने के लिए, इस रिस्पॉन्स ऑब्जेक्ट का इस्तेमाल करता है.
ज़्यादा जानकारी और उदाहरण के लिए, ड्राफ़्ट मैसेज लिखना देखें.