Action অবজেক্ট আপনাকে Google Workspace অ্যাড-অনগুলিতে ইন্টারেক্টিভ আচরণ তৈরি করতে দেয়। অ্যাড-অন UI-তে কোনও ব্যবহারকারী উইজেটের (উদাহরণস্বরূপ, একটি বোতাম) সাথে ইন্টারঅ্যাক্ট করলে কী ঘটে তা তারা সংজ্ঞায়িত করে।
একটি উইজেট হ্যান্ডলার ফাংশন ব্যবহার করে একটি প্রদত্ত উইজেটের সাথে একটি অ্যাকশন সংযুক্ত করা হয়, যা ক্রিয়াটিকে ট্রিগার করে এমন অবস্থাকেও সংজ্ঞায়িত করে। ট্রিগার করা হলে, কর্মটি একটি মনোনীত কলব্যাক ফাংশন চালায়। কলব্যাক ফাংশনটি একটি ইভেন্ট অবজেক্ট পাস করা হয় যা ব্যবহারকারীর ক্লায়েন্ট-সাইড মিথস্ক্রিয়া সম্পর্কে তথ্য বহন করে। আপনাকে অবশ্যই কলব্যাক ফাংশন বাস্তবায়ন করতে হবে এবং এটিকে একটি নির্দিষ্ট প্রতিক্রিয়া বস্তু ফিরিয়ে দিতে হবে।
উদাহরণস্বরূপ, বলুন আপনি একটি বোতাম চান যা ক্লিক করার সময় একটি নতুন কার্ড তৈরি করে এবং প্রদর্শন করে। এর জন্য, আপনাকে অবশ্যই একটি নতুন বোতাম উইজেট তৈরি করতে হবে এবং একটি কার্ড-বিল্ডিং Action সেট করতে বোতাম উইজেট হ্যান্ডলার ফাংশন setOnClickAction(action) ব্যবহার করতে হবে। আপনি যে Action সংজ্ঞায়িত করেছেন তা একটি Apps স্ক্রিপ্ট কলব্যাক ফাংশন নির্দিষ্ট করে যা বোতামটি ক্লিক করার সময় কার্যকর করে৷ এই ক্ষেত্রে, আপনি যে কার্ডটি চান তা তৈরি করতে এবং একটি ActionResponse অবজেক্ট ফেরত দিতে আপনি কলব্যাক ফাংশনটি বাস্তবায়ন করেন। রেসপন্স অবজেক্ট অ্যাড-অনকে বলে যে কার্ডটি কলব্যাক ফাংশন তৈরি করে প্রদর্শন করতে।
এই পৃষ্ঠাটি Gmail-নির্দিষ্ট উইজেট ক্রিয়াগুলির বর্ণনা করে যা আপনি আপনার অ্যাড-অনে অন্তর্ভুক্ত করতে পারেন৷
জিমেইল ইন্টারঅ্যাকশন
Google Workspace অ্যাড-অনগুলি যেগুলি Gmail প্রসারিত করে সেগুলি খসড়া বার্তাগুলি রচনা করার জন্য একটি অতিরিক্ত Gmail-নির্দিষ্ট উইজেট অ্যাকশন অন্তর্ভুক্ত করতে পারে। এই ক্রিয়াটির জন্য একটি বিশেষ প্রতিক্রিয়া বস্তু ফেরত দেওয়ার জন্য সংশ্লিষ্ট কর্ম কলব্যাক ফাংশন প্রয়োজন:
| অ্যাকশনের চেষ্টা করা হয়েছে | কলব্যাক ফাংশন ফিরে আসা উচিত |
|---|---|
| খসড়া বার্তা রচনা করুন | ComposeActionResponse |
এই উইজেট ক্রিয়া এবং প্রতিক্রিয়া অবজেক্টগুলি ব্যবহার করতে, অ্যাড-অনকে অবশ্যই তার ম্যানিফেস্টে https://www.googleapis.com/auth/gmail.addons.current.action.compose স্কোপ অন্তর্ভুক্ত করতে হবে৷
একটি বার্তা রচনা করুন
একটি Google Workspace অ্যাড-অন যা Gmail-কে প্রসারিত করে এমন একটি উইজেটকে সংজ্ঞায়িত করতে পারে যেটির সাথে ইন্টারঅ্যাক্ট করা হলে, Gmail এ খসড়া বার্তা তৈরি করে (নতুন বার্তা বা উত্তর)। এটি করার জন্য, আপনাকে ট্রিগারিং উইজেটটিকে একটি কলব্যাক ফাংশনের সাথে সংযুক্ত করতে হবে যা একটি ComposeActionResponse অবজেক্ট প্রদান করে। যখন কলব্যাক ফাংশনটি কার্যকর করা শেষ হয়, Gmail একটি খসড়া রচনা উইন্ডো খুলতে এবং পপুলেট করতে এই প্রতিক্রিয়া বস্তুটি ব্যবহার করে।
আরও বিশদ বিবরণ এবং একটি উদাহরণের জন্য, খসড়া বার্তা রচনা করুন দেখুন।