অ্যাড-অন অ্যাকশন

অ্যাড-অন অ্যাকশনগুলি উইজেটগুলিতে ইন্টারেক্টিভ আচরণ প্রদান করে। একটি অ্যাকশন তৈরি করে, আপনি নির্ধারণ করেন যে ব্যবহারকারী যখন একটি উইজেট নির্বাচন বা আপডেট করে তখন কী ঘটে।

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

এই সাধারণ প্রক্রিয়াটি ব্যবহার করে একটি Action সহ একটি উইজেট কনফিগার করুন:

  1. Action অবজেক্ট তৈরি করুন, কলব্যাক ফাংশনটি নির্দিষ্ট করে যা এটি কার্যকর করবে এবং এর জন্য প্রয়োজনীয় যেকোনো প্যারামিটারও উল্লেখ করুন।
  2. Action অবজেক্ট ব্যবহার করে উইজেটে উপযুক্ত উইজেট হ্যান্ডলার ফাংশনটি কল করুন।
  3. প্রয়োজনীয় আচরণ কার্যকর করতে কলব্যাক ফাংশনটি বাস্তবায়ন করুন।

উইজেট হ্যান্ডলার ফাংশন

একটি নির্দিষ্ট Action বা অন্য আচরণের সাথে একটি উইজেট লিঙ্ক করতে, আপনি একটি উইজেট হ্যান্ডলার ফাংশন ব্যবহার করেন। হ্যান্ডলার ফাংশন নির্ধারণ করে যে কোন ধরণের ইন্টারঅ্যাকশন (উদাহরণস্বরূপ, উইজেটে ক্লিক করা বা একটি টেক্সট ফিল্ড সম্পাদনা করা) অ্যাকশন আচরণকে ট্রিগার করে। হ্যান্ডলার ফাংশনটি অ্যাকশন সম্পূর্ণ হওয়ার পরে UI কোন পদক্ষেপ নেয়, যদি থাকে, তাও নির্ধারণ করে।

নিম্নলিখিত টেবিলে উইজেটের জন্য বিভিন্ন ধরণের হ্যান্ডলার এবং কোন উইজেটগুলির সাথে সেগুলি ব্যবহার করা হয় তা তালিকাভুক্ত করা হয়েছে:

হ্যান্ডলার ফাংশন ট্রিগার অ্যাকশন প্রযোজ্য উইজেট বিবরণ
setOnChangeAction() উইজেটের মান পরিবর্তন হয় DatePicker
DateTimePicker
SelectionInput
Switch
TextInput TimePicker		 উইজেট ফোকাস হারানোর সময় অ্যাপস স্ক্রিপ্ট ফাংশন কার্যকর করে এমন একটি Action সেট করে, যেমন যখন ব্যবহারকারী একটি ইনপুটে টেক্সট প্রবেশ করায় এবং এন্টার টিপে। হ্যান্ডলার স্বয়ংক্রিয়ভাবে একটি ইভেন্ট অবজেক্টকে তার কল করা ফাংশনে প্রেরণ করে। নির্বাচিত হলে আপনি এই ইভেন্ট অবজেক্টে অতিরিক্ত প্যারামিটার তথ্য সন্নিবেশ করতে পারেন।
setOnClickAction() ব্যবহারকারী উইজেটে ক্লিক করেন CardAction
Image
ImageButton
DecoratedText
TextButton		 ব্যবহারকারী যখন উইজেটে ক্লিক করে তখন একটি অ্যাপস স্ক্রিপ্ট ফাংশন কার্যকর করে এমন একটি Action সেট করে। হ্যান্ডলার স্বয়ংক্রিয়ভাবে একটি ইভেন্ট অবজেক্টকে তার কল করা ফাংশনে পাস করে। আপনি এই ইভেন্ট অবজেক্টে ঐচ্ছিক প্যারামিটার তথ্য সন্নিবেশ করতে পারেন।
setComposeAction() ব্যবহারকারী উইজেটে ক্লিক করেন CardAction
Image
ImageButton
DecoratedText
TextButton		 জিমেইল নির্দিষ্ট। একটি Action সেট করে যা একটি ইমেল ড্রাফ্ট তৈরি করে, তারপর একটি জিমেইল ইউআই কম্পোজ উইন্ডোতে ব্যবহারকারীর কাছে সেই ড্রাফ্টটি উপস্থাপন করে। আপনি ড্রাফ্টটি একটি নতুন বার্তা হিসাবে বা জিমেইলে খোলা বার্তার উত্তর হিসাবে তৈরি করতে পারেন। যখন হ্যান্ডলার ড্রাফ্ট-বিল্ডিং কলব্যাক ফাংশনটি কল করে, তখন এটি কলব্যাক ফাংশনে একটি ইভেন্ট অবজেক্ট পাস করে। আরও বিস্তারিত জানার জন্য কম্পোজ ড্রাফ্ট বার্তা দেখুন।
setOnClickOpenLinkAction() ব্যবহারকারী উইজেটে ক্লিক করেন CardAction
Image
ImageButton
DecoratedText
TextButton		 ব্যবহারকারী যখন উইজেটে ক্লিক করে তখন একটি URL খোলার জন্য একটি Action সেট করে। যখন আপনাকে URL তৈরি করতে হবে অথবা লিঙ্কটি খোলার আগে অন্যান্য ক্রিয়া সম্পাদন করতে হবে তখন এই হ্যান্ডলারটি ব্যবহার করুন; অন্যথায় setOpenLink() ব্যবহার করা সাধারণত সহজ। আপনি শুধুমাত্র একটি নতুন উইন্ডোতে URL খুলতে পারেন। বন্ধ হয়ে গেলে, আপনি UI কে অ্যাড-অনটি পুনরায় লোড করতে বাধ্য করতে পারেন।
setOpenLink() ব্যবহারকারী উইজেটে ক্লিক করেন CardAction
Image
ImageButton
DecoratedText
TextButton		 ব্যবহারকারী যখন উইজেটে ক্লিক করেন তখন সরাসরি একটি URL খোলে। যখন আপনি URLটি জানেন এবং শুধুমাত্র এটি খুলতে চান তখন এই হ্যান্ডলারটি ব্যবহার করুন; অন্যথায় setOnClickOpenLinkAction() ব্যবহার করুন। আপনি একটি নতুন উইন্ডোতে বা একটি ওভারলেতে URLটি খুলতে পারেন। বন্ধ হয়ে গেলে, আপনি UI কে অ্যাড-অনটি পুনরায় লোড করতে বাধ্য করতে পারেন।
setSuggestionsAction() ব্যবহারকারী একটি ইনপুটে টেক্সট প্রবেশ করান TextInput ব্যবহারকারী যখন একটি টেক্সট ইনপুট উইজেটে টেক্সট প্রবেশ করান তখন একটি অ্যাপস স্ক্রিপ্ট ফাংশন কার্যকর করে এমন একটি Action সেট করে। হ্যান্ডলার স্বয়ংক্রিয়ভাবে একটি ইভেন্ট অবজেক্টকে তার কল করা ফাংশনে পাস করে। আরও বিস্তারিত জানার জন্য টেক্সট ইনপুটগুলির জন্য স্বয়ংসম্পূর্ণ পরামর্শ দেখুন।

কলব্যাক ফাংশন

যখন কোনও Action ট্রিগার হয় তখন কলব্যাক ফাংশনগুলি কার্যকর হয়। যেহেতু কলব্যাক ফাংশন হল অ্যাপস স্ক্রিপ্ট ফাংশন, তাই আপনি এগুলিকে অন্য যেকোনো স্ক্রিপ্ট ফাংশন যা করতে পারে তার প্রায় সবকিছুই করতে পারেন।

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

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

পদক্ষেপ নেওয়ার চেষ্টা করা হয়েছে কলব্যাক ফাংশনটি ফিরে আসা উচিত
কার্ডগুলির মধ্যে নেভিগেট করুন ActionResponse
একটি Notification প্রদর্শন করুন ActionResponse
setOnClickOpenLinkAction() ব্যবহার করে একটি লিঙ্ক খুলুন। ActionResponse
স্বয়ংক্রিয়ভাবে সম্পূর্ণ করার পরামর্শগুলি প্রদর্শন করুন SuggestionResponse
একটি সর্বজনীন ক্রিয়া ব্যবহার করুন UniversalActionResponse
অন্যান্য কর্মকাণ্ড কিছুই না

Google Workspace হোস্ট অ্যাপ্লিকেশনের জন্য অ্যাকশন

এই ক্রিয়াগুলি ছাড়াও, প্রতিটি হোস্ট অ্যাপ্লিকেশনের নিজস্ব ক্রিয়াগুলির একটি সেট থাকে যা কেবল সেই হোস্টেই নেওয়া যেতে পারে। বিস্তারিত জানার জন্য, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

অ্যাকশন ইভেন্ট অবজেক্ট

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

অ্যাকশন ইভেন্ট অবজেক্টের একটি নির্দিষ্ট JSON কাঠামো থাকে যা তাদের মধ্যে থাকা তথ্যগুলিকে সংগঠিত করে। যখন একটি হোমপেজ ট্রিগার একটি হোমপেজ তৈরি করতে সক্রিয় হয়, অথবা যখন একটি প্রাসঙ্গিক ট্রিগার অ্যাড-অন ডিসপ্লে আপডেট করতে সক্রিয় হয় তখন একই কাঠামো ব্যবহার করা হয়।

ইভেন্ট অবজেক্টের গঠনের সম্পূর্ণ ব্যাখ্যার জন্য ইভেন্ট অবজেক্ট দেখুন।