Class SelectionInput

SelectionInput

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

यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.

var 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"));

var 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 — चेन बनाने के लिए यह ऑब्जेक्ट.