একটি ক্রিয়া যা UI উপাদানগুলির মধ্যে ইন্টারঅ্যাক্টিভিটি সক্ষম করে৷ ক্রিয়াটি সরাসরি ক্লায়েন্টের উপর ঘটে না বরং ঐচ্ছিক পরামিতি সহ একটি Apps স্ক্রিপ্ট কলব্যাক ফাংশন আহ্বান করে৷
Google Workspace অ্যাড-অন এবং Google Chat অ্যাপের জন্য উপলভ্য।
var image = CardService.newImage()
.setOnClickAction(CardService.newAction()
.setFunctionName("handleImageClick")
.setParameters({imageSrc: 'carImage'}));পদ্ধতি
| পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
|---|---|---|
addRequiredWidget(requiredWidget) | Action | এই অ্যাকশনটি একটি বৈধ জমা দেওয়ার জন্য প্রয়োজন এমন উইজেটগুলির নাম যোগ করে। |
setAllWidgetsAreRequired(allWidgetsAreRequired) | Action | এই ক্রিয়াটির জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা তা নির্দেশ করে৷ |
setFunctionName(functionName) | Action | কল করার জন্য কলব্যাক ফাংশনের নাম সেট করে। |
setInteraction(interaction) | Action | একটি ব্যবহারকারীর সাথে মিথস্ক্রিয়া সেট করে, শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন৷ |
setLoadIndicator(loadIndicator) | Action | লোডিং সূচক সেট করে যা ক্রিয়া চলাকালীন প্রদর্শিত হয়। |
setParameters(parameters) | Action | কাস্টম প্যারামিটারগুলিকে কলব্যাক ফাংশনে পাস করার অনুমতি দেয়। |
setPersistValues(persistValues) | Action | একটি অ্যাকশন রেসপন্স ফর্মের Card আপডেট করার পরে ফর্মের মানগুলি ক্লায়েন্টের মান বা সার্ভারের মান দ্বারা নির্ধারিত হয় কিনা তা নির্দেশ করে৷ |
বিস্তারিত ডকুমেন্টেশন
addRequiredWidget(requiredWidget)
এই অ্যাকশনটি একটি বৈধ জমা দেওয়ার জন্য প্রয়োজন এমন উইজেটগুলির নাম যোগ করে। এই ক্রিয়াটি আহ্বান করার সময় যদি এই তালিকার উইজেটগুলির একটি মান না থাকে তবে ফর্ম জমা দেওয়া বাতিল করা হয়৷
শুধুমাত্র Google Chat অ্যাপের জন্য উপলব্ধ। Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ নয়।
var textInput = CardService.newTextInput()
.setFieldName("text_input_1")
.setTitle("Text input title")
// Creates a footer button that requires an input from the above TextInput Widget.
var action = CardService.newAction()
.setFunctionName("notificationCallback")
.addRequiredWidget("text_input_1");
var fixedFooter =
CardService
.newFixedFooter()
.setPrimaryButton(
CardService
.newTextButton()
.setText("help")
.setOnClickAction(action));পরামিতি
| নাম | টাইপ | বর্ণনা |
|---|---|---|
requiredWidget | String | এই অ্যাকশনের জন্য প্রয়োজনীয় উইজেটের নাম। |
প্রত্যাবর্তন
Action - এই বস্তুটি, চেইনিংয়ের জন্য।
setAllWidgetsAreRequired(allWidgetsAreRequired)
এই ক্রিয়াটির জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা তা নির্দেশ করে৷
শুধুমাত্র Google Chat অ্যাপের জন্য উপলব্ধ। Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ নয়।
// Creates a button with an action that requires inputs from all widgets.
const button = CardService.newTextButton()
.setText('Create notification')
.setOnClickAction(
CardService.newAction()
.setAllWidgetsAreRequired(true));পরামিতি
| নাম | টাইপ | বর্ণনা |
|---|---|---|
allWidgetsAreRequired | Boolean | কর্মের জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা। ডিফল্ট থেকে false । |
প্রত্যাবর্তন
Action - এই বস্তুটি, চেইনিংয়ের জন্য।
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 - এই বস্তুটি, চেইনিংয়ের জন্য।