একটি ক্রিয়া যা UI উপাদানগুলির মধ্যে ইন্টারঅ্যাক্টিভিটি সক্ষম করে৷ ক্রিয়াটি সরাসরি ক্লায়েন্টের উপর ঘটে না বরং ঐচ্ছিক পরামিতি সহ একটি Apps স্ক্রিপ্ট কলব্যাক ফাংশন আহ্বান করে৷
Google Workspace অ্যাড-অন এবং Google Chat অ্যাপের জন্য উপলভ্য।
var image = CardService.newImage() .setOnClickAction(CardService.newAction() .setFunctionName("handleImageClick") .setParameters({imageSrc: 'carImage'}));
পদ্ধতি
পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বর্ণনা |
---|---|---|
setFunctionName(functionName) | Action | কল করার জন্য কলব্যাক ফাংশনের নাম সেট করে। |
setInteraction(interaction) | Action | একটি ব্যবহারকারীর সাথে মিথস্ক্রিয়া সেট করে, শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন৷ |
setLoadIndicator(loadIndicator) | Action | লোডিং সূচক সেট করে যা ক্রিয়া চলাকালীন প্রদর্শিত হয়। |
setParameters(parameters) | Action | কাস্টম প্যারামিটারগুলিকে কলব্যাক ফাংশনে পাস করার অনুমতি দেয়। |
setPersistValues(persistValues) | Action | একটি অ্যাকশন রেসপন্স ফর্মের Card আপডেট করার পরে ফর্মের মানগুলি ক্লায়েন্টের মান বা সার্ভারের মান দ্বারা নির্ধারিত হয় কিনা তা নির্দেশ করে৷ |
বিস্তারিত ডকুমেন্টেশন
setFunctionName(functionName)
কল করার জন্য কলব্যাক ফাংশনের নাম সেট করে। প্রয়োজন।
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
functionName | String | ফাংশনের নাম। আপনি অন্তর্ভুক্ত লাইব্রেরি থেকে ফাংশন ব্যবহার করতে পারেন, যেমন Library.libFunction1 । |
প্রত্যাবর্তন
Action
- এই বস্তুটি, চেইনিংয়ের জন্য।
setInteraction(interaction)
একটি ব্যবহারকারীর সাথে মিথস্ক্রিয়া সেট করে, শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন৷ অনির্দিষ্ট থাকলে, অ্যাপটি একটি Action
সম্পাদন করে প্রতিক্রিয়া জানায় যেমন একটি লিঙ্ক খোলা বা একটি ফাংশন চালানো — স্বাভাবিক হিসাবে।
শুধুমাত্র Google Chat অ্যাপের জন্য উপলব্ধ। Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ নয়।
const action = CardService.newAction() .setFunctionName('handleDialog') .setInteraction(CardService.Interaction.OPEN_DIALOG);
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
interaction | Interaction | নির্দিষ্ট করার মিথস্ক্রিয়া। |
প্রত্যাবর্তন
Action
- এই বস্তুটি, চেইনিংয়ের জন্য।
setLoadIndicator(loadIndicator)
লোডিং সূচক সেট করে যা ক্রিয়া চলাকালীন প্রদর্শিত হয়।
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
loadIndicator | LoadIndicator | প্রদর্শনের জন্য সূচক। |
প্রত্যাবর্তন
Action
- এই বস্তুটি, চেইনিংয়ের জন্য।
setParameters(parameters)
কাস্টম প্যারামিটারগুলিকে কলব্যাক ফাংশনে পাস করার অনুমতি দেয়। ঐচ্ছিক।
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
parameters | Object | উভয় কী এবং মান অবশ্যই স্ট্রিং হতে হবে। |
প্রত্যাবর্তন
Action
- এই বস্তুটি, চেইনিংয়ের জন্য।
setPersistValues(persistValues)
একটি অ্যাকশন রেসপন্স ফর্মের Card
আপডেট করার পরে ফর্মের মানগুলি ক্লায়েন্টের মান বা সার্ভারের মান দ্বারা নির্ধারিত হয় কিনা তা নির্দেশ করে৷ true
সেট করা হলে, সার্ভারের প্রতিক্রিয়ার পরে ক্লায়েন্টের মান বজায় থাকে। false
সেট করা হলে, সার্ভারের মানগুলি ফর্মের মানগুলিকে ওভাররাইট করে৷ ডিফল্ট থেকে false
।
ক্লায়েন্ট মান ধরে রাখা এমন পরিস্থিতিতে প্রতিরোধ করতে সাহায্য করে যেখানে ব্যবহারকারীর সম্পাদনা করার পরে একটি ফর্ম অপ্রত্যাশিতভাবে পরিবর্তিত হয়। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী একটি ফর্ম জমা দেওয়ার পরে একটি TextInput
এ সম্পাদনা করে, কিন্তু সার্ভার প্রতিক্রিয়া জানানোর আগে। যদি মানগুলি অব্যাহত থাকে, সার্ভার প্রতিক্রিয়া Card
আপডেট করার পরে ব্যবহারকারীর সম্পাদনাটি থেকে যায়; অন্যথায় ফর্মের মান সেই মানটিতে ফিরে আসে যা ব্যবহারকারী মূলত ফর্মে জমা দিয়েছিলেন।
স্থায়ী ক্লায়েন্ট মানগুলি আপনার স্ক্রিপ্টের ফর্ম ক্ষেত্রগুলি সাফ করার বা ফর্মের মানগুলিকে ওভাররাইড করার ক্ষমতাতে হস্তক্ষেপ করতে পারে, তাই এই ধরণের কার্যকারিতার জন্য স্থিরতা চালু করা এড়িয়ে চলুন৷ দৃঢ়তা ছাড়া, ইভেন্টের জন্য LoadIndicator.SPINNER
ব্যবহার করার পরামর্শ দেওয়া হচ্ছে, কারণ এটি UI লক করে এবং সার্ভারের প্রতিক্রিয়া জানানোর আগে ব্যবহারকারীর সম্পাদনাগুলিকে বাধা দেয়। বিকল্পভাবে, আপনি LoadIndicator.NONE
ব্যবহার করতে পারেন এবং ফর্মের প্রতিটি উপাদানের একটি onChange অ্যাকশন রয়েছে তা নিশ্চিত করুন।
// Creates a button with an action that persists the client's values as the on-click action. const button = CardService.newTextButton() .setText('Create notification') .setOnClickAction( CardService.newAction() .setPersistValues(true) .setFunctionName('functionName'));
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
persistValues | Boolean | মান বজায় রাখতে হবে কিনা। ডিফল্ট থেকে false । |
প্রত্যাবর্তন
Action
- এই বস্তুটি, চেইনিংয়ের জন্য।