জিমেইল অ্যাকশন

Action অবজেক্ট আপনাকে গুগল ওয়ার্কস্পেস অ্যাড-অনগুলিতে ইন্টারেক্টিভ আচরণ তৈরি করতে দেয়। অ্যাড-অন UI-তে কোনো ব্যবহারকারী যখন কোনো উইজেটের (যেমন, একটি বাটন) সাথে ইন্টারঅ্যাক্ট করে, তখন কী ঘটবে তা এগুলি নির্ধারণ করে।

একটি উইজেট হ্যান্ডলার ফাংশন ব্যবহার করে কোনো নির্দিষ্ট উইজেটের সাথে একটি অ্যাকশন সংযুক্ত করা হয়, যা অ্যাকশনটি ট্রিগার করার শর্তটিও নির্ধারণ করে। ট্রিগার হলে, অ্যাকশনটি একটি নির্দিষ্ট কলব্যাক ফাংশন কার্যকর করে। কলব্যাক ফাংশনটিতে একটি ইভেন্ট অবজেক্ট পাস করা হয়, যা ব্যবহারকারীর ক্লায়েন্ট-সাইড ইন্টারঅ্যাকশন সম্পর্কিত তথ্য বহন করে। আপনাকে অবশ্যই কলব্যাক ফাংশনটি ইমপ্লিমেন্ট করতে হবে এবং এর থেকে একটি নির্দিষ্ট রেসপন্স অবজেক্ট রিটার্ন করাতে হবে।

উদাহরণস্বরূপ, ধরুন আপনি এমন একটি বাটন চান যা ক্লিক করলে একটি নতুন কার্ড তৈরি করে প্রদর্শন করবে। এর জন্য, আপনাকে অবশ্যই একটি নতুন বাটন উইজেট তৈরি করতে হবে এবং একটি কার্ড-বিল্ডিং Action সেট করার জন্য বাটন উইজেট হ্যান্ডলার ফাংশন setOnClickAction(action) ব্যবহার করতে হবে। আপনার নির্ধারিত Action একটি অ্যাপস স্ক্রিপ্ট কলব্যাক ফাংশন নির্দিষ্ট করে, যা বাটনটি ক্লিক করা হলে এক্সিকিউট হয়। এই ক্ষেত্রে, আপনি আপনার কাঙ্ক্ষিত কার্ডটি তৈরি করার জন্য কলব্যাক ফাংশনটি ইমপ্লিমেন্ট করবেন এবং একটি ActionResponse অবজেক্ট রিটার্ন করবেন। রেসপন্স অবজেক্টটি অ্যাড-অনকে কলব্যাক ফাংশন দ্বারা তৈরি করা কার্ডটি প্রদর্শন করতে নির্দেশ দেয়।

এই পৃষ্ঠায় জিমেইল-এর জন্য নির্দিষ্ট উইজেট অ্যাকশনগুলো বর্ণনা করা হয়েছে, যা আপনি আপনার অ্যাড-অনে অন্তর্ভুক্ত করতে পারেন।

জিমেইল মিথস্ক্রিয়া

জিমেইলকে সম্প্রসারিত করে এমন গুগল ওয়ার্কস্পেস অ্যাড-অনগুলিতে খসড়া বার্তা রচনার জন্য একটি অতিরিক্ত জিমেইল-নির্দিষ্ট উইজেট অ্যাকশন অন্তর্ভুক্ত থাকতে পারে। এই অ্যাকশনটির জন্য সংশ্লিষ্ট অ্যাকশন কলব্যাক ফাংশনটিকে একটি বিশেষায়িত রেসপন্স অবজেক্ট রিটার্ন করতে হয়:

পদক্ষেপের চেষ্টা করা হয়েছিল	কলব্যাক ফাংশন ফেরত দেওয়া উচিত
খসড়া বার্তা রচনা করুন	ComposeActionResponse

এই উইজেট অ্যাকশন এবং রেসপন্স অবজেক্টগুলো ব্যবহার করার জন্য, গুগল ওয়ার্কস্পেস অ্যাড-অনটির ম্যানিফেস্টে অবশ্যই https://www.googleapis.com/auth/gmail.addons.current.action.compose স্কোপটি অন্তর্ভুক্ত থাকতে হবে।

একটি বার্তা রচনা করুন

জিমেইলের কার্যকারিতা সম্প্রসারণকারী অ্যাড-অনগুলো এমন একটি উইজেট নির্ধারণ করতে পারে, যা ব্যবহার করা হলে জিমেইলে খসড়া বার্তা (নতুন বার্তা বা উত্তর) তৈরি করে। এটি করার জন্য, ট্রিগারিং উইজেটটিকে একটি কলব্যাক ফাংশনের সাথে যুক্ত করতে হয়, যা একটি ComposeActionResponse অবজেক্ট রিটার্ন করে। কলব্যাক ফাংশনটির এক্সিকিউশন শেষ হলে, জিমেইল এই রেসপন্স অবজেক্টটি ব্যবহার করে একটি ড্রাফট কম্পোজ উইন্ডো খোলে এবং তাতে তথ্য যোগ করে।

আরও বিস্তারিত তথ্য ও উদাহরণের জন্য, খসড়া বার্তা রচনা দেখুন।