Class Action

অ্যাকশন

একটি ক্রিয়া যা UI উপাদানগুলির মধ্যে ইন্টারঅ্যাক্টিভিটি সক্ষম করে৷ ক্রিয়াটি সরাসরি ক্লায়েন্টের উপর ঘটে না বরং ঐচ্ছিক পরামিতি সহ একটি Apps স্ক্রিপ্ট কলব্যাক ফাংশন আহ্বান করে৷

Google Workspace অ্যাড-অন এবং Google Chat অ্যাপের জন্য উপলভ্য।

const image = CardService.newImage().setOnClickAction(
    CardService.newAction().setFunctionName('handleImageClick').setParameters({
      imageSrc: 'carImage'
    }),
);

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Required Widget(requiredWidget) Action এই অ্যাকশনটি একটি বৈধ জমা দেওয়ার জন্য প্রয়োজন এমন উইজেটগুলির নাম যোগ করে।
set All Widgets Are Required(allWidgetsAreRequired) Action এই ক্রিয়াটির জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা তা নির্দেশ করে৷
set Function Name(functionName) Action কল করার জন্য কলব্যাক ফাংশনের নাম সেট করে।
set Interaction(interaction) Action একটি ব্যবহারকারীর সাথে মিথস্ক্রিয়া সেট করে, শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন৷
set Load Indicator(loadIndicator) Action লোডিং সূচক সেট করে যা ক্রিয়া চলাকালীন প্রদর্শিত হয়।
set Parameters(parameters) Action কাস্টম প্যারামিটারগুলিকে কলব্যাক ফাংশনে পাস করার অনুমতি দেয়।
set Persist Values(persistValues) Action একটি অ্যাকশন রেসপন্স ফর্মের Card আপডেট করার পরে ফর্মের মানগুলি ক্লায়েন্টের মান বা সার্ভারের মান দ্বারা নির্ধারিত হয় কিনা তা নির্দেশ করে৷

বিস্তারিত ডকুমেন্টেশন

add Required Widget(requiredWidget)

এই অ্যাকশনটি একটি বৈধ জমা দেওয়ার জন্য প্রয়োজন এমন উইজেটগুলির নাম যোগ করে। এই ক্রিয়াটি আহ্বান করার সময় যদি এই তালিকার উইজেটগুলির একটি মান না থাকে তবে ফর্ম জমা দেওয়া বাতিল করা হয়৷

শুধুমাত্র Google Chat অ্যাপের জন্য উপলব্ধ। Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ নয়।

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_1')
                      .setTitle('Text input title');

// Creates a footer button that requires an input from the above TextInput
// Widget.
const action = CardService.newAction()
                   .setFunctionName('notificationCallback')
                   .addRequiredWidget('text_input_1');
const fixedFooter = CardService.newFixedFooter().setPrimaryButton(
    CardService.newTextButton().setText('help').setOnClickAction(action),
);

পরামিতি

নাম টাইপ বর্ণনা
required Widget String এই অ্যাকশনের জন্য প্রয়োজনীয় উইজেটের নাম।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

set All Widgets Are Required(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));

পরামিতি

নাম টাইপ বর্ণনা
all Widgets Are Required Boolean কর্মের জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা। ডিফল্ট থেকে false ।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

set Function Name(functionName)

কল করার জন্য কলব্যাক ফাংশনের নাম সেট করে। প্রয়োজন।

পরামিতি

নাম টাইপ বর্ণনা
function Name String ফাংশনের নাম। আপনি অন্তর্ভুক্ত লাইব্রেরি থেকে ফাংশন ব্যবহার করতে পারেন, যেমন Library.libFunction1 ।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

set Interaction(interaction)

একটি ব্যবহারকারীর সাথে মিথস্ক্রিয়া সেট করে, শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন৷ অনির্দিষ্ট থাকলে, অ্যাপটি একটি Action সম্পাদন করে প্রতিক্রিয়া জানায় যেমন একটি লিঙ্ক খোলা বা একটি ফাংশন চালানো — স্বাভাবিক হিসাবে।

শুধুমাত্র Google Chat অ্যাপের জন্য উপলব্ধ। Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ নয়।

const action = CardService.newAction()
                   .setFunctionName('handleDialog')
                   .setInteraction(CardService.Interaction.OPEN_DIALOG);

পরামিতি

নাম টাইপ বর্ণনা
interaction Interaction নির্দিষ্ট করার মিথস্ক্রিয়া।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

set Load Indicator(loadIndicator)

লোডিং সূচক সেট করে যা ক্রিয়া চলাকালীন প্রদর্শিত হয়।

পরামিতি

নাম টাইপ বর্ণনা
load Indicator Load Indicator প্রদর্শনের জন্য সূচক।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

set Parameters(parameters)

কাস্টম প্যারামিটারগুলিকে কলব্যাক ফাংশনে পাস করার অনুমতি দেয়। ঐচ্ছিক।

পরামিতি

নাম টাইপ বর্ণনা
parameters Object উভয় কী এবং মান অবশ্যই স্ট্রিং হতে হবে।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

set Persist Values(persistValues)

একটি অ্যাকশন রেসপন্স ফর্মের Card আপডেট করার পরে ফর্মের মানগুলি ক্লায়েন্টের মান বা সার্ভারের মান দ্বারা নির্ধারিত হয় কিনা তা নির্দেশ করে৷ true সেট করা হলে, সার্ভারের প্রতিক্রিয়ার পরে ক্লায়েন্টের মান বজায় থাকে। false সেট করা হলে, সার্ভারের মানগুলি ফর্মের মানগুলিকে ওভাররাইট করে৷ ডিফল্ট থেকে false ।

ক্লায়েন্ট মান ধরে রাখা এমন পরিস্থিতিতে প্রতিরোধ করতে সাহায্য করে যেখানে ব্যবহারকারীর সম্পাদনা করার পরে একটি ফর্ম অপ্রত্যাশিতভাবে পরিবর্তিত হয়। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী একটি ফর্ম জমা দেওয়ার পরে একটি Text Input একটি সম্পাদনা করে, কিন্তু সার্ভার প্রতিক্রিয়া জানানোর আগে। যদি মানগুলি অব্যাহত থাকে, সার্ভার প্রতিক্রিয়া Card আপডেট করার পরে ব্যবহারকারীর সম্পাদনাটি থেকে যায়; অন্যথায় ফর্মের মান সেই মানটিতে ফিরে আসে যা ব্যবহারকারী মূলত ফর্মে জমা দিয়েছিলেন।

স্থায়ী ক্লায়েন্ট মানগুলি আপনার স্ক্রিপ্টের ফর্ম ক্ষেত্রগুলি সাফ করতে বা ফর্মের মানগুলিকে ওভাররাইড করার ক্ষমতাতে হস্তক্ষেপ করতে পারে, তাই এই ধরণের কার্যকারিতার জন্য স্থিরতা চালু করা এড়িয়ে চলুন৷ অধ্যবসায় ছাড়া, ইভেন্টের জন্য Load Indicator.SPINNER ব্যবহার করার পরামর্শ দেওয়া হচ্ছে, কারণ এটি UI লক করে এবং সার্ভারের প্রতিক্রিয়া জানানোর আগে ব্যবহারকারীর সম্পাদনাগুলিকে বাধা দেয়৷ বিকল্পভাবে, আপনি Load Indicator.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'),
        );

পরামিতি

নাম টাইপ বর্ণনা
persist Values Boolean মান বজায় রাখতে হবে কিনা। ডিফল্ট থেকে false ।

প্রত্যাবর্তন

Action - এই বস্তুটি, চেইনিংয়ের জন্য।

অপ্রচলিত পদ্ধতি