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)	SelectionInput	Google Workspace से डेटा सोर्स सेट करता है.
setTitle(title)	SelectionInput	इनपुट फ़ील्ड से पहले दिखाए जाने के लिए टाइटल को सेट करता है.
setType(type)	SelectionInput	इस इनपुट का टाइप सेट करता है.

विस्तृत दस्तावेज़

addItem(text, value, selected)

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

नाम	टाइप	ब्यौरा
text	Object	इस आइटम के लिए दिखाया जाने वाला टेक्स्ट. नॉन-स्ट्रिंग प्रिमिटिव आर्ग्युमेंट को स्ट्रिंग को अपने-आप कॉन्फ़िगर कर दिया जाता है.
value	Object	कॉलबैक के ज़रिए भेजी गई फ़ॉर्म इनपुट वैल्यू. नॉन-स्ट्रिंग प्रिमिटिव आर्ग्युमेंट अपने-आप स्ट्रिंग में बदल जाते हैं.
selected	Boolean	आइटम, डिफ़ॉल्ट रूप से चुना हुआ है या नहीं. अगर चुने गए इनपुट के लिए सिर्फ़ स्वीकार किया जाता है एक वैल्यू (जैसे, रेडियो बटन या ड्रॉपडाउन मेन्यू) के लिए, इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें.
startIconUri	Object	एक से ज़्यादा आइटम चुनने के लिए, आइटम के बगल में दिखाए गए आइकॉन का यूआरएल टेक्स्ट फ़ील्ड में डालें. PNG और JPEG फ़ॉर्मैट में फ़ाइलें इस्तेमाल की जा सकती हैं.
bottomText	Object	कई आइटम चुनने के लिए बनाए गए मेन्यू के लिए, टेक्स्ट की जानकारी या लेबल आइटम की टेक्स्ट फ़ील्ड.

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

---

setFieldName(fieldName)

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

---

setOnChangeAction(action)

यह विकल्प, चुने गए इनपुट के बदलने पर होने वाले Action को सेट करता है.

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

---

setTitle(title)

इनपुट फ़ील्ड से पहले दिखाए जाने के लिए टाइटल को सेट करता है.

पैरामीटर

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

वापसी का टिकट

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

---

setType(type)

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

पैरामीटर

नाम	टाइप	ब्यौरा
type	SelectionInputType	चुनाव का टाइप.

वापसी का टिकट

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