Class SelectionInput

নির্বাচন ইনপুট

একটি ইনপুট ক্ষেত্র যা পূর্বনির্ধারিত বিকল্পগুলির একটি সেটের মধ্যে নির্বাচন করার অনুমতি দেয়।

শুধুমাত্র Selection Input Type.DROP_DOWN এবং Selection Input Type.MULTI_SELECT মেনুগুলির জন্য ফর্ম জমা দেওয়ার বৈধতা সমর্থন করে। যখন Action.setAllWidgetsAreRequired(allWidgetsAreRequired) true সেট করা হয় অথবা এই উইজেটটি Action.addRequiredWidget(requiredWidget) এর মাধ্যমে নির্দিষ্ট করা হয়, তখন একটি মান নির্বাচন না করা পর্যন্ত জমা দেওয়ার ক্রিয়াটি ব্লক করা হয়।

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

const checkboxGroup =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.CHECK_BOX)
        .setTitle('A group of checkboxes. Multiple selections are allowed.')
        .setFieldName('checkbox_field')
        .addItem('checkbox one title', 'checkbox_one_value', false)
        .addItem('checkbox two title', 'checkbox_two_value', true)
        .addItem('checkbox three title', 'checkbox_three_value', true)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleCheckboxChange'),
        );

const radioGroup =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.RADIO_BUTTON)
        .setTitle(
            'A group of radio buttons. Only a single selection is allowed.')
        .setFieldName('checkbox_field')
        .addItem('radio button one title', 'radio_one_value', true)
        .addItem('radio button two title', 'radio_two_value', false)
        .addItem('radio button three title', 'radio_three_value', false);

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('multiselect')
        .setTitle('A multi select input example.')
        .addMultiSelectItem(
            'Contact 1',
            'contact-1',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact one description',
            )
        .addMultiSelectItem(
            'Contact 2',
            'contact-2',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact two description',
            )
        .addMultiSelectItem(
            'Contact 3',
            'contact-3',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact three description',
            )
        .addMultiSelectItem(
            'Contact 4',
            'contact-4',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact four description',
            )
        .addMultiSelectItem(
            'Contact 5',
            'contact-5',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact five description',
            )
        .setMultiSelectMaxSelectedItems(3)
        .setMultiSelectMinQueryLength(1);

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Data Source Config(dataSourceConfig) Selection Input নির্বাচন নিয়ন্ত্রণের জন্য ডেটা সোর্স কনফিগারেশন সেট করে।
add Event Action(eventAction) Widget উইজেটে সম্পাদিত হতে পারে এমন ইভেন্ট অ্যাকশন যোগ করে।
add Item(text, value, selected) Selection Input নির্বাচন করা যেতে পারে এমন একটি নতুন আইটেম যোগ করে।
add Multi Select Item(text, value, selected, startIconUri, bottomText) Selection Input একাধিক-নির্বাচন মেনুগুলির জন্য একটি নতুন আইটেম যোগ করে যা নির্বাচন করা যেতে পারে।
set External Data Source(action) Selection Input বাহ্যিক ডেটা উৎস সেট করে, যেমন একটি রিলেশনাল ডেটা বেস।
set Field Name(fieldName) Selection Input UI ইন্টারঅ্যাকশনের সময় উৎপন্ন ইভেন্ট অবজেক্টে এই নির্বাচন ইনপুট সনাক্তকারী কী সেট করে।
set Id(id) Widget রূপান্তরিত করার জন্য উইজেট সনাক্ত করতে ব্যবহৃত অনন্য আইডি সেট করে।
set Multi Select Max Selected Items(maxSelectedItems) Selection Input একজন ব্যবহারকারী সর্বোচ্চ কতগুলি আইটেম নির্বাচন করতে পারবেন তা নির্ধারণ করে।
set Multi Select Min Query Length(queryLength) Selection Input অ্যাপ কোয়েরি স্বয়ংক্রিয়ভাবে সম্পন্ন করার আগে ব্যবহারকারী কতগুলি টেক্সট অক্ষর ইনপুট করে তা সেট করে এবং কার্ডে প্রস্তাবিত আইটেমগুলি প্রদর্শন করে।
set On Change Action(action) Selection Input নির্বাচন ইনপুট পরিবর্তন হলে সম্পাদিত একটি Action সেট করে।
set Platform Data Source(platformDataSource) Selection Input Google Workspace থেকে একটি ডেটা সোর্স সেট করে।
set Title(title) Selection Input ইনপুট ক্ষেত্রের আগে দেখানোর জন্য শিরোনাম সেট করে।
set Type(type) Selection Input এই ইনপুটের ধরণ নির্ধারণ করে।
set Visibility(visibility) Widget উইজেটের দৃশ্যমানতা সেট করে।

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

add Data Source Config(dataSourceConfig)

নির্বাচন নিয়ন্ত্রণের জন্য ডেটা সোর্স কনফিগারেশন সেট করে। এই ক্ষেত্রটি ডেটা সোর্সের উপর আরও সূক্ষ্ম নিয়ন্ত্রণ প্রদান করে। এটি একটি ঐচ্ছিক ক্ষেত্র।

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('contacts')
        .setTitle('Selected contacts')
        .setDataSourceConfig(
            CardService.newDataSourceConfig().setPlatformDataSource(
                CardService.newPlatformDataSource().setCommonDataSource(
                    CardService.CommonDataSource.USER,
                )
            )
        );

পরামিতি

নাম আদর্শ বিবরণ
data Source Config Data Source Config নির্বাচন ইনপুটে প্রয়োগ করা ডেটা সোর্স কনফিগারেশন।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


add Event Action(eventAction)

উইজেটে সম্পাদিত হতে পারে এমন ইভেন্ট অ্যাকশন যোগ করে।

পরামিতি

নাম আদর্শ বিবরণ
event Action Event Action Event Action যোগ করা হবে।

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

Widget — চেইন করার জন্য বস্তু।


add Item(text, value, selected)

নির্বাচন করা যেতে পারে এমন একটি নতুন আইটেম যোগ করে।

পরামিতি

নাম আদর্শ বিবরণ
text Object এই আইটেমের জন্য যে টেক্সটটি দেখানো হবে। নন-স্ট্রিং প্রিমিটিভ আর্গুমেন্টগুলি স্বয়ংক্রিয়ভাবে স্ট্রিংয়ে রূপান্তরিত হয়।
value Object কলব্যাকের মাধ্যমে পাঠানো ফর্ম ইনপুট মান। নন-স্ট্রিং প্রিমিটিভ আর্গুমেন্টগুলি স্বয়ংক্রিয়ভাবে স্ট্রিংয়ে রূপান্তরিত হয়।
selected Boolean আইটেমটি ডিফল্টরূপে নির্বাচিত কিনা। যদি নির্বাচন ইনপুট শুধুমাত্র একটি মান গ্রহণ করে (যেমন রেডিও বোতাম বা ড্রপডাউন মেনু), তাহলে শুধুমাত্র একটি আইটেমের জন্য এই ক্ষেত্রটি সেট করুন।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


add Multi Select Item(text, value, selected, startIconUri, bottomText)

একাধিক-নির্বাচন মেনুগুলির জন্য একটি নতুন আইটেম যোগ করে যা নির্বাচন করা যেতে পারে।

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('multiselect')
        .setTitle('A multi select input example.')
        .addMultiSelectItem(
            'Contact 1',
            'contact-1',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact one description',
            )
        .addMultiSelectItem(
            'Contact 2',
            'contact-2',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact two description',
            )
        .addMultiSelectItem(
            'Contact 3',
            'contact-3',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact three description',
            )
        .addMultiSelectItem(
            'Contact 4',
            'contact-4',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact four description',
            )
        .addMultiSelectItem(
            'Contact 5',
            'contact-5',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact five description',
        );

পরামিতি

নাম আদর্শ বিবরণ
text Object এই আইটেমের জন্য যে টেক্সটটি দেখানো হবে। নন-স্ট্রিং প্রিমিটিভ আর্গুমেন্টগুলি স্বয়ংক্রিয়ভাবে স্ট্রিংয়ে রূপান্তরিত হয়।
value Object কলব্যাকের মাধ্যমে পাঠানো ফর্ম ইনপুট মান। নন-স্ট্রিং প্রিমিটিভ আর্গুমেন্টগুলি স্বয়ংক্রিয়ভাবে স্ট্রিংয়ে রূপান্তরিত হয়।
selected Boolean আইটেমটি ডিফল্টরূপে নির্বাচিত কিনা। যদি নির্বাচন ইনপুট শুধুমাত্র একটি মান গ্রহণ করে (যেমন রেডিও বোতাম বা ড্রপডাউন মেনু), তাহলে শুধুমাত্র একটি আইটেমের জন্য এই ক্ষেত্রটি সেট করুন।
start Icon Uri Object মাল্টিসিলেক্ট মেনুর জন্য, আইটেমের টেক্সট ফিল্ডের পাশে প্রদর্শিত আইকনের URL। PNG এবং JPEG ফাইল সমর্থন করে।
bottom Text Object মাল্টিসিলেক্ট মেনুর জন্য, আইটেমের টেক্সট ফিল্ডের নিচে প্রদর্শিত একটি টেক্সট বিবরণ বা লেবেল।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set External Data Source(action)

বাহ্যিক ডেটা উৎস সেট করে, যেমন একটি রিলেশনাল ডেটা বেস।

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('contacts')
        .setTitle('Selected contacts')
        .addMultiSelectItem(
            'Contact 3',
            'contact-3',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact three description',
            )
        .setMultiSelectMaxSelectedItems(5)
        .setMultiSelectMinQueryLength(2)
        .setExternalDataSource(
            CardService.newAction().setFunctionName('getContacts'),
        );

পরামিতি

নাম আদর্শ বিবরণ
action Action বাহ্যিক তথ্য উৎস।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Field Name(fieldName)

UI ইন্টারঅ্যাকশনের সময় তৈরি হওয়া ইভেন্ট অবজেক্টে এই নির্বাচন ইনপুট সনাক্তকারী কী সেট করে। ব্যবহারকারীর কাছে দৃশ্যমান নয়। প্রয়োজনীয়, অনন্য হতে হবে।

পরামিতি

নাম আদর্শ বিবরণ
field Name String এই ইনপুটটিতে যে নামটি বরাদ্দ করা হবে।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Id(id)

মিউটেশনের জন্য উইজেট শনাক্ত করতে ব্যবহৃত অনন্য আইডি সেট করে। উইজেট মিউটেশন শুধুমাত্র অ্যাড-অনগুলিতে সমর্থিত।

পরামিতি

নাম আদর্শ বিবরণ
id String উইজেটের আইডি, যার সীমা ৬৪ অক্ষর এবং `[a-zA-Z0-9-]+` ফর্ম্যাটে।

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

Widget — এই অবজেক্টটি, চেইন করার জন্য।


set Multi Select Max Selected Items(maxSelectedItems)

একজন ব্যবহারকারী সর্বোচ্চ কতগুলি আইটেম নির্বাচন করতে পারবেন তা নির্ধারণ করে।

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('multiselect')
        .setTitle('A multi select input example.')
        .setMultiSelectMaxSelectedItems(3)
        .addMultiSelectItem(
            'Contact 1',
            'contact-1',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact one description',
            )
        .addMultiSelectItem(
            'Contact 2',
            'contact-2',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact two description',
            )
        .addMultiSelectItem(
            'Contact 3',
            'contact-3',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact three description',
            )
        .addMultiSelectItem(
            'Contact 4',
            'contact-4',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact four description',
            )
        .addMultiSelectItem(
            'Contact 5',
            'contact-5',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact five description',
        );

পরামিতি

নাম আদর্শ বিবরণ
max Selected Items Integer আইটেমের সর্বাধিক সংখ্যা।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Multi Select Min Query Length(queryLength)

অ্যাপ কোয়েরি স্বয়ংক্রিয়ভাবে সম্পন্ন করার আগে ব্যবহারকারী কতগুলি টেক্সট অক্ষর ইনপুট করে তা সেট করে এবং কার্ডে প্রস্তাবিত আইটেমগুলি প্রদর্শন করে।

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('multiselect')
        .setTitle('A multi select input example.')
        .setMultiSelectMinQueryLength(1)
        .addMultiSelectItem(
            'Contact 1',
            'contact-1',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact one description',
            )
        .addMultiSelectItem(
            'Contact 2',
            'contact-2',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact two description',
            )
        .addMultiSelectItem(
            'Contact 3',
            'contact-3',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact three description',
            )
        .addMultiSelectItem(
            'Contact 4',
            'contact-4',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact four description',
            )
        .addMultiSelectItem(
            'Contact 5',
            'contact-5',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact five description',
        );

পরামিতি

নাম আদর্শ বিবরণ
query Length Integer টেক্সট অক্ষরের সংখ্যা।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set On Change Action(action)

নির্বাচন ইনপুট পরিবর্তন হলে সম্পাদিত একটি Action সেট করে।

পরামিতি

নাম আদর্শ বিবরণ
action Action পদক্ষেপ নিতে হবে।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Platform Data Source(platformDataSource)

Google Workspace থেকে একটি ডেটা সোর্স সেট করে। মাল্টিসিলেক্ট মেনুতে আইটেমগুলি পূরণ করতে ব্যবহৃত হয়।

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('contacts')
        .setTitle('Selected contacts')
        .setPlatformDataSource(
            CardService.newPlatformDataSource().setCommonDataSource(
                CardService.CommonDataSource.USER,
                ),
        );
শুধুমাত্র Google Chat অ্যাপের জন্য উপলব্ধ। Google Workspace অ্যাড-অনের জন্য উপলব্ধ নয়।

পরামিতি

নাম আদর্শ বিবরণ
platform Data Source Platform Data Source তথ্য উৎস।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Title(title)

ইনপুট ক্ষেত্রের আগে দেখানোর জন্য শিরোনাম সেট করে।

পরামিতি

নাম আদর্শ বিবরণ
title String ইনপুট ক্ষেত্রের শিরোনাম।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Type(type)

এই ইনপুটের ধরণ সেট করে। ডিফল্টরূপে CHECKBOX থাকে।

পরামিতি

নাম আদর্শ বিবরণ
type Selection Input Type নির্বাচনের ধরণ।

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

Selection Input — চেইনিংয়ের জন্য এই বস্তু।


set Visibility(visibility)

উইজেটের দৃশ্যমানতা সেট করে। ডিফল্ট মান হল `VISIBLE`।

পরামিতি

নাম আদর্শ বিবরণ
visibility Visibility উইজেটের Visibility

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

Widget — চেইন করার জন্য বস্তু।