यह एक इनपुट फ़ील्ड विजेट है, जो टेक्स्ट इनपुट स्वीकार करता है.
फ़ॉर्म सबमिट करने की पुष्टि करने की सुविधा उपलब्ध है. Action.setAllWidgetsAreRequired(allWidgetsAreRequired) को true पर सेट करने या Action.addRequiredWidget(requiredWidget) के ज़रिए इस विजेट को तय करने पर, सबमिट करने की कार्रवाई तब तक ब्लॉक रहती है, जब तक कोई वैल्यू नहीं डाली जाती.
यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.
const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint');
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
set | Text | यह उस कुंजी को सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट किए गए इवेंट ऑब्जेक्ट में इस टेक्स्ट इनपुट की पहचान करती है. |
set | Text | इस विकल्प से, टेक्स्ट इनपुट के लिए हिंट सेट किया जाता है. |
set | Text | Google Workspace ऐप्लिकेशन से डेटा सोर्स सेट करता है. |
set | Text | इससे यह तय होता है कि इनपुट टेक्स्ट एक लाइन में दिखेगा या कई लाइनों में. |
set | Text | इस कुकी का इस्तेमाल, टेक्स्ट इनपुट में बदलाव होने पर कोई कार्रवाई सेट करने के लिए किया जाता है. |
set | Text | यह विकल्प, टेक्स्ट फ़ील्ड में अपने-आप पूरा होने की सुविधा के लिए सुझाव सेट करता है. |
set | Text | यह कुकी, अपने-आप पूरा होने की सुविधा के लिए उपयोगकर्ता के इनपुट के आधार पर सुझाव पाने के लिए, कॉलबैक ऐक्शन सेट करती है. |
set | Text | इससे इनपुट फ़ील्ड के ऊपर दिखने वाला टाइटल सेट किया जाता है. |
set | Text | यह विकल्प, इस विजेट के लिए पुष्टि करने का नियम सेट करता है. |
set | Text | इनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है. |
ज़्यादा जानकारी वाला दस्तावेज़
set Field Name(fieldName)
यह उस कुंजी को सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट किए गए इवेंट ऑब्जेक्ट में इस टेक्स्ट इनपुट की पहचान करती है. यह उपयोगकर्ता को नहीं दिखेगा. यह ज़रूरी है और यूनीक होना चाहिए.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
field | String | इस इनपुट की पहचान करने के लिए इस्तेमाल की जाने वाली कुंजी. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए है.
set Hint(hint)
इस विकल्प से, टेक्स्ट इनपुट के लिए हिंट सेट किया जाता है. इस कुकी का इस्तेमाल, उपयोगकर्ता को यह बताने के लिए किया जाता है कि उसे क्या इनपुट करना है. उदाहरण के लिए, किसी फ़ोन नंबर फ़ील्ड के लिए, हिंट में फ़ॉर्मैट ("xxx-xxx-xxxx") के बारे में बताया जा सकता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
hint | String | इनपुट फ़ील्ड के नीचे दिखाने के लिए टेक्स्ट हिंट. यह टेक्स्ट हमेशा दिखता है. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set Host App Data Source(hostAppDataSource)
Google Workspace ऐप्लिकेशन से डेटा सोर्स सेट करता है. फ़िलहाल, यह सुविधा उपयोगकर्ताओं और Chat स्पेस के लिए उपलब्ध है.
यह सुविधा सिर्फ़ Gemini Alpha प्रोग्राम के ज़रिए उपलब्ध है. यह Google Workspace के ऐड-ऑन के लिए है, जो Google Workspace Flows को बेहतर बनाते हैं.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint') .setHostAppDataSource(hostAppDataSource);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
host | Host | डेटा सोर्स. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set Multiline(multiline)
इससे यह तय होता है कि इनपुट टेक्स्ट एक लाइन में दिखेगा या कई लाइनों में.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
multiline | Boolean | मल्टीलाइन सेटिंग. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set On Change Action(action)
set Suggestions(suggestions)
यह विकल्प, टेक्स्ट फ़ील्ड में अपने-आप पूरा होने की सुविधा के लिए सुझाव सेट करता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
suggestions | Suggestions | इस्तेमाल किए जाने वाले सुझावों का कलेक्शन. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set Suggestions Action(suggestionsAction)
यह कुकी, अपने-आप पूरा होने की सुविधा के लिए उपयोगकर्ता के इनपुट के आधार पर सुझाव पाने के लिए, कॉलबैक ऐक्शन सेट करती है. Action पैरामीटर में, एक ऐसा कॉलबैक फ़ंक्शन तय करना होगा जो Suggestions ऑब्जेक्ट दिखाता है.
const action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({numSuggestions: 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { const suggestions = CardService.newSuggestions(); const numSuggestions = Number.parseInt(e.parameter.numSuggestions); for (let i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion(`Suggestion ${i}`); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
suggestions | Action | यह कार्रवाई, इस इनपुट के लिए सुझावों को फ़ेच करती है. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set Title(title)
इससे इनपुट फ़ील्ड के ऊपर दिखने वाला टाइटल सेट किया जाता है. ज़रूरी है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
title | String | इस इनपुट के लिए टेक्स्ट लेबल. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set Validation(validation)
यह विकल्प, इस विजेट के लिए पुष्टि करने का नियम सेट करता है.
const validation = CardService.newValidation().setCharacterLimit('10').setType( CardService.InputType.TEXT); const input = CardService.newTextInput() .setFieldName('text_name_xxx1') .setTitle('Max 10 characters') .setValidation(validation);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
validation | Validation | इस Text विजेट के लिए पुष्टि करने का नियम. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए.
set Value(value)
इनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
value | String | इनपुट में डिफ़ॉल्ट वैल्यू डाली गई है. इसे हमेशा फ़ॉर्म कॉलबैक पैरामीटर में स्ट्रिंग के तौर पर दिखाया जाता है. |
वापसी का टिकट
Text — यह ऑब्जेक्ट, चेनिंग के लिए है.