Class SelectionInput

चुना गयाइनपुट

ऐसा इनपुट फ़ील्ड जिसमें पहले से तय विकल्पों के सेट में से कोई विकल्प चुना जा सकता है.

सिर्फ़ SelectionInputType.DROP_DOWN और SelectionInputType.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);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addItem(text, value, selected)SelectionInputएक नया आइटम जोड़ता है, जिसे चुना जा सकता है.
addMultiSelectItem(text, value, selected, startIconUri, bottomText)SelectionInputएक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, एक नया आइटम जोड़ता है.
setExternalDataSource(action)SelectionInputबाहरी डेटा सोर्स सेट करता है, जैसे कि रिलेशनल डेटाबेस.
setFieldName(fieldName)SelectionInputवह कुंजी सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, चुने गए इस इनपुट की पहचान करता है.
setMultiSelectMaxSelectedItems(maxSelectedItems)SelectionInputइससे यह तय होता है कि कोई उपयोगकर्ता ज़्यादा से ज़्यादा कितने आइटम चुन सकता है.
setMultiSelectMinQueryLength(queryLength)SelectionInputयह टेक्स्ट वर्ण की संख्या सेट करता है. उपयोगकर्ता इस संख्या के हिसाब से टेक्स्ट डालता है, ताकि ऐप्लिकेशन ऑटोकंप्लीट की सुविधा का इस्तेमाल करके, कार्ड पर सुझाए गए आइटम दिखा सके.
setOnChangeAction(action)SelectionInputजब भी चुने गए इनपुट में बदलाव होता है, तो Action को सेट किया जाता है.
setPlatformDataSource(platformDataSource)SelectionInputGoogle Workspace से डेटा सोर्स सेट करता है.
setTitle(title)SelectionInputइनपुट फ़ील्ड के आगे दिखने वाला टाइटल सेट करता है.
setType(type)SelectionInputइस इनपुट का टाइप सेट करता है.

ज़्यादा जानकारी वाला दस्तावेज़

addItem(text, value, selected)

एक नया आइटम जोड़ता है, जिसे चुना जा सकता है.

पैरामीटर

नामटाइपब्यौरा
textObjectइस आइटम के लिए दिखाया जाने वाला टेक्स्ट. नॉन-स्ट्रिंग प्राइमिटिव आर्ग्युमेंट, अपने-आप स्ट्रिंग में बदल जाते हैं.
valueObjectकॉलबैक के ज़रिए भेजी गई फ़ॉर्म इनपुट वैल्यू. स्ट्रिंग प्राइमटिव आर्ग्युमेंट के अलावा, अन्य आर्ग्युमेंट को स्ट्रिंग में अपने-आप बदल दिया जाता है.
selectedBooleanआइटम डिफ़ॉल्ट रूप से चुना गया है या नहीं. अगर चुनने के लिए दिया गया इनपुट सिर्फ़ एक वैल्यू स्वीकार करता है, जैसे कि रेडियो बटन या ड्रॉपडाउन मेन्यू के लिए, तो इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

addMultiSelectItem(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',
        );

पैरामीटर

नामटाइपब्यौरा
textObjectइस आइटम के लिए दिखाया जाने वाला टेक्स्ट. नॉन-स्ट्रिंग प्राइमिटिव आर्ग्युमेंट, अपने-आप स्ट्रिंग में बदल जाते हैं.
valueObjectकॉलबैक के ज़रिए भेजी गई फ़ॉर्म इनपुट वैल्यू. स्ट्रिंग प्राइमटिव आर्ग्युमेंट के अलावा, अन्य आर्ग्युमेंट को स्ट्रिंग में अपने-आप बदल दिया जाता है.
selectedBooleanआइटम डिफ़ॉल्ट रूप से चुना गया है या नहीं. अगर चुनने के लिए दिया गया इनपुट सिर्फ़ एक वैल्यू स्वीकार करता है, जैसे कि रेडियो बटन या ड्रॉपडाउन मेन्यू के लिए, तो इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें.
startIconUriObjectएक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, आइटम के टेक्स्ट फ़ील्ड के बगल में दिखने वाले आइकॉन का यूआरएल. PNG और JPEG फ़ाइलों के साथ काम करता है.
bottomTextObjectएक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, आइटम के टेक्स्ट फ़ील्ड के नीचे दिखने वाला टेक्स्ट ब्यौरा या लेबल.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setExternalDataSource(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'),
        );

पैरामीटर

नामटाइपब्यौरा
actionActionबाहरी डेटा सोर्स.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setFieldName(fieldName)

वह कुंजी सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, चुने गए इस इनपुट की पहचान करता है. यह उपयोगकर्ता को नहीं दिखता. यह ज़रूरी है और यूनीक होना चाहिए.

पैरामीटर

नामटाइपब्यौरा
fieldNameStringइस इनपुट को असाइन किया जाने वाला नाम.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setMultiSelectMaxSelectedItems(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',
        );

पैरामीटर

नामटाइपब्यौरा
maxSelectedItemsIntegerआइटम की ज़्यादा से ज़्यादा संख्या.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setMultiSelectMinQueryLength(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',
        );

पैरामीटर

नामटाइपब्यौरा
queryLengthIntegerटेक्स्ट वर्णों की संख्या.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setOnChangeAction(action)

जब भी चुना गया इनपुट बदलता है, तो Action को सेट किया जाता है.

पैरामीटर

नामटाइपब्यौरा
actionActionकी जाने वाली कार्रवाई.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setPlatformDataSource(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 के ऐड-ऑन के लिए उपलब्ध नहीं है.

पैरामीटर

नामटाइपब्यौरा
platformDataSourcePlatformDataSourceडेटा सोर्स.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setTitle(title)

इनपुट फ़ील्ड के आगे दिखने वाला टाइटल सेट करता है.

पैरामीटर

नामटाइपब्यौरा
titleStringइनपुट फ़ील्ड का टाइटल.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.

setType(type)

इस इनपुट का टाइप सेट करता है. डिफ़ॉल्ट रूप से, यह CHECKBOX पर सेट होती है.

पैरामीटर

नामटाइपब्यौरा
typeSelectionInputTypeचुनने का तरीका.

वापसी का टिकट

SelectionInput — चेन करने के लिए यह ऑब्जेक्ट.