একটি ইনপুট ক্ষেত্র যা পূর্বনির্ধারিত বিকল্পগুলির একটি সেটের মধ্যে নির্বাচন করার অনুমতি দেয়।
শুধুমাত্র 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, ), );
পরামিতি
| নাম | আদর্শ | বিবরণ |
|---|---|---|
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 — চেইন করার জন্য বস্তু।