Package google.apps.card.v1

string

यह एक कस्टम फ़ंक्शन है, जो एलिमेंट पर क्लिक करने या उसे किसी अन्य तरीके से चालू करने पर ट्रिगर होता है.

इस्तेमाल के उदाहरण के लिए, फ़ॉर्म का डेटा पढ़ें देखें.

ActionParameter

ऐक्शन पैरामीटर की सूची.

LoadIndicator

यह लोड होने की जानकारी देने वाले इंडिकेटर के बारे में बताता है, जो कॉल-टू-ऐक्शन करते समय ऐक्शन दिखाता है.

bool

इससे पता चलता है कि कार्रवाई के बाद, फ़ॉर्म की वैल्यू सेव रहती हैं या नहीं. डिफ़ॉल्ट वैल्यू false है.

अगर true है, तो कार्रवाई ट्रिगर होने के बाद भी फ़ॉर्म की वैल्यू बनी रहती हैं. कार्रवाई की प्रोसेस के दौरान, उपयोगकर्ता को बदलाव करने की अनुमति देने के लिए, LoadIndicator को NONE पर सेट करें. चैट ऐप्लिकेशन में कार्ड मैसेज के लिए, आपको कार्रवाई के ResponseType को UPDATE_MESSAGE पर भी सेट करना होगा. साथ ही, उस कार्ड से उसी card_id का इस्तेमाल करना होगा जिसमें कार्रवाई शामिल थी.

अगर false है, तो कार्रवाई ट्रिगर होने पर फ़ॉर्म की वैल्यू मिट जाती हैं. कार्रवाई की प्रोसेस के दौरान, उपयोगकर्ता को बदलाव करने से रोकने के लिए, LoadIndicator को SPINNER पर सेट करें.

Interaction

ज़रूरी नहीं. डायलॉग खोलने के लिए ज़रूरी है.

उपयोगकर्ता के इंटरैक्शन के जवाब में क्या करना है. जैसे, उपयोगकर्ता कार्ड मैसेज में मौजूद बटन पर क्लिक करना.

अगर कोई कार्रवाई नहीं बताई जाती है, तो ऐप्लिकेशन सामान्य तरीके से action को लागू करके जवाब देता है. जैसे, कोई लिंक खोलना या कोई फ़ंक्शन चलाना.

interaction की वैल्यू तय करके, ऐप्लिकेशन खास इंटरैक्टिव तरीकों से जवाब दे सकता है. उदाहरण के लिए, interaction को OPEN_DIALOG पर सेट करके, ऐप्लिकेशन कोई डायलॉग खोल सकता है. अगर यह जानकारी दी जाती है, तो लोड होने की जानकारी देने वाला इंडिकेटर नहीं दिखाया जाता. अगर किसी ऐड-ऑन के लिए तय किया गया है, तो पूरा कार्ड हटा दिया जाता है और क्लाइंट में कुछ भी नहीं दिखाया जाता.

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

string

ज़रूरी नहीं. इस सूची में उन विजेट के नाम डालें जिनकी ज़रूरत इस कार्रवाई को मान्य तौर पर सबमिट करने के लिए है.

अगर इस ऐक्शन को ट्रिगर करने पर, यहां दिए गए विजेट में कोई वैल्यू नहीं होती है, तो फ़ॉर्म सबमिट नहीं किया जाता.

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

bool

ज़रूरी नहीं. अगर यह सही है, तो इस कार्रवाई के लिए सभी विजेट ज़रूरी माने जाते हैं.

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

string

ऐक्शन स्क्रिप्ट के लिए पैरामीटर का नाम.

string

पैरामीटर की वैल्यू.

BorderType

बॉर्डर का टाइप.

Color

BORDER_TYPE_STROKE टाइप होने पर इस्तेमाल किए जाने वाले रंग.

स्ट्रोक का रंग सेट करने के लिए, red, green, और blue फ़ील्ड के लिए वैल्यू डालें. वैल्यू, आरजीबी कलर वैल्यू के आधार पर 0 से 1 के बीच की फ़्लोट संख्या होनी चाहिए. इसमें 0 (0/255) का मतलब है कि रंग नहीं है और 1 (255/255) का मतलब है कि रंग की तीव्रता सबसे ज़्यादा है.

उदाहरण के लिए, यह फ़ंक्शन रंग को सबसे ज़्यादा तीव्रता के साथ लाल पर सेट करता है:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

स्ट्रोक के रंग के लिए alpha फ़ील्ड उपलब्ध नहीं है. अगर इस फ़ील्ड की वैल्यू दी जाती है, तो इसे अनदेखा कर दिया जाता है.

int32

बॉर्डर के कोने का रेडियस.

string

बटन के अंदर दिखने वाला टेक्स्ट.

Icon

बटन के अंदर दिखने वाला आइकॉन. अगर icon और text, दोनों सेट हैं, तो आइकॉन टेक्स्ट से पहले दिखता है.

Color

ज़रूरी नहीं. बटन का रंग. अगर यह सेट है, तो बटन type को FILLED पर सेट किया जाता है. साथ ही, text और icon फ़ील्ड के रंग को, पढ़ने के लिए अलग-अलग रंग पर सेट किया जाता है. उदाहरण के लिए, अगर बटन का रंग नीले रंग पर सेट है, तो बटन में मौजूद कोई भी टेक्स्ट या आइकॉन सफ़ेद रंग पर सेट हो जाता है.

बटन का रंग सेट करने के लिए, red, green, और blue फ़ील्ड के लिए वैल्यू सबमिट करें. वैल्यू, आरजीबी कलर वैल्यू के आधार पर 0 से 1 के बीच की फ़्लोट संख्या होनी चाहिए. इसमें 0 (0/255) का मतलब है कि रंग नहीं है और 1 (255/255) का मतलब है कि रंग की तीव्रता सबसे ज़्यादा है.

उदाहरण के लिए, यह फ़ंक्शन रंग को सबसे ज़्यादा तीव्रता के साथ लाल पर सेट करता है:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

बटन के रंग के लिए alpha फ़ील्ड उपलब्ध नहीं है. अगर इस फ़ील्ड की वैल्यू दी जाती है, तो इसे अनदेखा कर दिया जाता है.

OnClick

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

bool

अगर true है, तो बटन बंद स्थिति में दिखता है और उपयोगकर्ता की कार्रवाइयों का जवाब नहीं देता.

string

सुलभता के लिए इस्तेमाल किया जाने वाला वैकल्पिक टेक्स्ट.

बटन के बारे में जानकारी देने वाला टेक्स्ट सेट करें, ताकि उपयोगकर्ताओं को पता चल सके कि बटन का क्या काम है. उदाहरण के लिए, अगर कोई बटन हाइपरलिंक खोलता है, तो आपके पास यह लिखने का विकल्प होता है: "यह एक नया ब्राउज़र टैब खोलता है और https://developers.google.com/workspace/chat" पर Google Chat के डेवलपर दस्तावेज़ पर ले जाता है.

Type

ज़रूरी नहीं. बटन का टाइप. अगर इस विकल्प को सेट नहीं किया जाता है, तो बटन का टाइप डिफ़ॉल्ट रूप से OUTLINED पर सेट होता है. अगर color फ़ील्ड सेट है, तो बटन टाइप को FILLED पर सेट कर दिया जाता है. साथ ही, इस फ़ील्ड के लिए सेट की गई किसी भी वैल्यू को अनदेखा कर दिया जाता है.

Button

बटनों का कलेक्शन.

CardHeader

कार्ड का हेडर. आम तौर पर, हेडर में एक मुख्य इमेज और टाइटल होता है. हेडर हमेशा कार्ड में सबसे ऊपर दिखते हैं.

Section

इसमें विजेट का कलेक्शन होता है. हर सेक्शन का अपना हेडर होता है, जो ज़रूरी नहीं है. सेक्शन को एक लाइन से अलग किया जाता है. Google Chat ऐप्लिकेशन में उदाहरण के लिए, कार्ड का सेक्शन तय करना देखें.

DividerStyle

हेडर, सेक्शन, और फ़ुटर के बीच के डिवाइडर का स्टाइल.

CardAction

कार्ड की कार्रवाइयां. कार्रवाइयां, कार्ड के टूलबार मेन्यू में जोड़ दी जाती हैं.

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

उदाहरण के लिए, यहां दिया गया JSON, Settings और Send Feedback विकल्पों के साथ कार्ड ऐक्शन मेन्यू बनाता है:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

कार्ड का नाम. कार्ड नेविगेशन में, कार्ड आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाता है.

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

CardFixedFooter

इस कार्ड में सबसे नीचे दिखने वाला फ़िक्स्ड फ़ुटर.

primaryButton या secondaryButton की जानकारी दिए बिना fixedFooter सेट करने पर गड़बड़ी होती है. Chat ऐप्लिकेशन के लिए, डायलॉग में फ़िक्स किए गए फ़ुटर का इस्तेमाल किया जा सकता है, लेकिन कार्ड मैसेज में नहीं.

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

DisplayStyle

Google Workspace ऐड-ऑन में, peekCardHeader की डिसप्ले प्रॉपर्टी सेट करता है.

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

CardHeader

संदर्भ के हिसाब से कॉन्टेंट दिखाते समय, झलक दिखाने वाले कार्ड का हेडर प्लेसहोल्डर के तौर पर काम करता है. इससे उपयोगकर्ता, होम पेज के कार्ड और संदर्भ के हिसाब से दिखाए जाने वाले कार्ड के बीच आगे-पीछे जा सकता है.

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

string

वह लेबल जो ऐक्शन मेन्यू आइटम के तौर पर दिखता है.

OnClick

इस ऐक्शन आइटम के लिए onClick कार्रवाई.

Button

फ़िक्स किए गए फ़ुटर का मुख्य बटन. बटन, टेक्स्ट बटन होना चाहिए, जिसमें टेक्स्ट और रंग सेट हो.

Button

फ़िक्स किए गए फ़ुटर का सेकंडरी बटन. बटन, टेक्स्ट बटन होना चाहिए, जिसमें टेक्स्ट और रंग सेट हो. अगर secondaryButton सेट है, तो आपको primaryButton भी सेट करना होगा.

string

ज़रूरी है. कार्ड हेडर का टाइटल. हेडर की ऊंचाई तय होती है: अगर टाइटल और सबटाइटल, दोनों दिए गए हैं, तो हर एक के लिए एक लाइन का इस्तेमाल होता है. अगर सिर्फ़ टाइटल दिया गया है, तो वह दोनों लाइनों में दिखता है.

string

कार्ड हेडर का सबटाइटल. अगर यह जानकारी दी गई है, तो यह title के नीचे अपनी लाइन पर दिखती है.

ImageType

इमेज को काटने के लिए इस्तेमाल किया जाने वाला आकार.

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

string

कार्ड हेडर में मौजूद इमेज का एचटीटीपीएस यूआरएल.

string

इस इमेज का वैकल्पिक टेक्स्ट, जिसका इस्तेमाल सुलभता के लिए किया जाता है.

TextParagraph

टेक्स्ट पैराग्राफ़ विजेट.

ButtonList

बटन की सूची वाला विजेट.

Image

इमेज विजेट.

string

सेक्शन में सबसे ऊपर दिखने वाला टेक्स्ट. इसमें एचटीएमएल फ़ॉर्मैट में लिखा गया आसान टेक्स्ट इस्तेमाल किया जा सकता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace के ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

Widget

सेक्शन में मौजूद सभी विजेट. इसमें कम से कम एक विजेट होना चाहिए.

bool

इससे पता चलता है कि इस सेक्शन को छोटा किया जा सकता है या नहीं.

छोटा किए जा सकने वाले सेक्शन में, कुछ या सभी विजेट छिप जाते हैं. हालांकि, उपयोगकर्ता ज़्यादा दिखाएं पर क्लिक करके, सेक्शन को बड़ा करके छिपे हुए विजेट देख सकते हैं. उपयोगकर्ता, कम दिखाएं पर क्लिक करके विजेट को फिर से छिपा सकते हैं.

यह तय करने के लिए कि कौनसे विजेट छिपे हैं, uncollapsibleWidgetsCount तय करें.

int32

ऐसे विजेट की संख्या जिन्हें छोटा नहीं किया जा सकता. ये विजेट, सेक्शन को छोटा करने पर भी दिखते रहते हैं.

उदाहरण के लिए, जब किसी सेक्शन में पांच विजेट होते हैं और uncollapsibleWidgetsCount को 2 पर सेट किया जाता है, तो पहले दो विजेट हमेशा दिखते हैं और आखिरी तीन विजेट डिफ़ॉल्ट रूप से छोटा कर दिए जाते हैं. uncollapsibleWidgetsCount का इस्तेमाल सिर्फ़ तब किया जाता है, जब collapsible की वैल्यू true हो.

CollapseControl

ज़रूरी नहीं. सेक्शन को बड़ा और छोटा करने वाले बटन को तय करें. यह बटन सिर्फ़ तब दिखेगा, जब सेक्शन को छोटा किया जा सकता हो. अगर यह फ़ील्ड सेट नहीं है, तो डिफ़ॉल्ट बटन का इस्तेमाल किया जाता है.

CarouselCard

कैरसेल में शामिल कार्ड की सूची.

NestedWidget

कैरसेल कार्ड में दिखाए गए विजेट की सूची. विजेट उसी क्रम में दिखाए जाते हैं जिस क्रम में उन्हें जोड़ा गया है.

NestedWidget

कैरसेल कार्ड में सबसे नीचे दिखने वाले विजेट की सूची. विजेट उसी क्रम में दिखाए जाते हैं जिस क्रम में उन्हें जोड़ा गया है.

Icon

आइकॉन की इमेज. अगर icon और text, दोनों सेट हैं, तो आइकॉन टेक्स्ट से पहले दिखता है.

string

चिप के अंदर दिखने वाला टेक्स्ट.

OnClick

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

bool

चिप चालू है या नहीं और वह उपयोगकर्ता की कार्रवाइयों का जवाब देती है या नहीं. डिफ़ॉल्ट रूप से, यह true पर सेट होती है. समर्थन नहीं होना या रुकना. इसके बजाय, disabled का इस्तेमाल करें.

bool

क्या चिप बंद है और वह उपयोगकर्ता की कार्रवाइयों को अनदेखा करती है. डिफ़ॉल्ट रूप से, यह false पर सेट होती है.

string

सुलभता के लिए इस्तेमाल किया जाने वाला वैकल्पिक टेक्स्ट.

जानकारी देने वाला टेक्स्ट सेट करें, ताकि उपयोगकर्ताओं को पता चल सके कि चिप क्या करता है. उदाहरण के लिए, अगर कोई चिप हाइपरलिंक खोलता है, तो लिखें: "यह एक नया ब्राउज़र टैब खोलता है और https://developers.google.com/workspace/chat" पर Google Chat के डेवलपर दस्तावेज़ पर ले जाता है.

Layout

चिप की सूची का तय किया गया लेआउट.

Chip

चिप का कलेक्शन.

HorizontalAlignment

बड़ा और छोटा करने वाले बटन का हॉरिज़ॉन्टल अलाइनमेंट.

Button

ज़रूरी नहीं. सेक्शन को बड़ा करने के लिए, पसंद के मुताबिक बटन तय करें. expandButton और collapseButton, दोनों फ़ील्ड सेट होने चाहिए. सिर्फ़ एक फ़ील्ड सेट लागू नहीं होगा. अगर यह फ़ील्ड सेट नहीं है, तो डिफ़ॉल्ट बटन का इस्तेमाल किया जाता है.

Button

ज़रूरी नहीं. सेक्शन को छोटा करने के लिए, पसंद के मुताबिक बटन तय करें. expandButton और collapseButton, दोनों फ़ील्ड सेट होने चाहिए. सिर्फ़ एक फ़ील्ड सेट लागू नहीं होगा. अगर यह फ़ील्ड सेट नहीं है, तो डिफ़ॉल्ट बटन का इस्तेमाल किया जाता है.

Column

कॉलम का अरे. किसी कार्ड या डायलॉग में ज़्यादा से ज़्यादा दो कॉलम शामिल किए जा सकते हैं.

HorizontalSizeStyle

यह बताता है कि कोई कॉलम, कार्ड की चौड़ाई को कैसे भरता है.

HorizontalAlignment

इससे यह तय होता है कि विजेट, कॉलम के बाएं, दाएं या बीच में अलाइन हों.

VerticalAlignment

इससे यह तय होता है कि विजेट, कॉलम के ऊपर, नीचे या बीच में अलाइन हों.

Widgets

किसी कॉलम में शामिल विजेट की सूची. विजेट उसी क्रम में दिखते हैं जिस क्रम में उन्हें जोड़ा गया है.

TextParagraph

TextParagraph विजेट.

Image

Image विजेट.

DecoratedText

DecoratedText विजेट.

ButtonList

ButtonList विजेट.

TextInput

TextInput विजेट.

SelectionInput

SelectionInput विजेट.

DateTimePicker

DateTimePicker विजेट.

ChipList

ChipList विजेट.

HostAppDataActionMarkup

Google Workspace के डेटा को अपडेट करने का तरीका बताता है.

string

वह नाम जिससे फ़ॉर्म इनपुट इवेंट में DateTimePicker की पहचान की जाती है.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

string

वह टेक्स्ट जो उपयोगकर्ताओं को तारीख, समय या तारीख और समय डालने के लिए कहता है. उदाहरण के लिए, अगर उपयोगकर्ता अपॉइंटमेंट शेड्यूल कर रहे हैं, तो Appointment date या Appointment date and time जैसे लेबल का इस्तेमाल करें.

DateTimePickerType

विजेट में तारीख, समय या तारीख और समय डाला जा सकता है या नहीं.

int64

विजेट में दिखाई गई डिफ़ॉल्ट वैल्यू, यूनिक्स टाइम के बाद से मिलीसेकंड में.

पिकर के टाइप (DateTimePickerType) के आधार पर वैल्यू तय करें:

• DATE_AND_TIME: यूटीसी में कैलेंडर की तारीख और समय. उदाहरण के लिए, 1 जनवरी, 2023 को दोपहर 12:00 बजे यूटीसी दिखाने के लिए, 1672574400000 का इस्तेमाल करें.
• DATE_ONLY: यूटीसी के हिसाब से, कैलेंडर की तारीख 00:00:00. उदाहरण के लिए, 1 जनवरी, 2023 को दिखाने के लिए, 1672531200000 का इस्तेमाल करें.
• TIME_ONLY: यूटीसी में समय. उदाहरण के लिए, दोपहर 12:00 बजे के लिए, 43200000 (या 12 * 60 * 60 * 1000) का इस्तेमाल करें.

int32

यूटीसी से टाइम ज़ोन के ऑफ़सेट को मिनट में दिखाने वाली संख्या. अगर यह सेट है, तो value_ms_epoch को तय किए गए टाइम ज़ोन में दिखाया जाता है. अगर यह पैरामीटर सेट नहीं है, तो डिफ़ॉल्ट रूप से उपयोगकर्ता के टाइम ज़ोन की सेटिंग लागू होती है.

Action

जब उपयोगकर्ता DateTimePicker इंटरफ़ेस से सेव करें या मिटाएं पर क्लिक करता है, तब ट्रिगर होता है.

Icon

startIcon के पक्ष में, अब काम नहीं करता.

Icon

टेक्स्ट के सामने दिखने वाला आइकॉन.

string

text के ऊपर दिखने वाला टेक्स्ट. हमेशा काटकर दिखाता है.

string

ज़रूरी है. मुख्य टेक्स्ट.

इसमें आसान फ़ॉर्मैटिंग की सुविधा होती है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace के ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

bool

टेक्स्ट रैप करने की सेटिंग. अगर true है, तो टेक्स्ट रैप हो जाता है और कई लाइनों में दिखता है. ऐसा न करने पर, टेक्स्ट को छोटा कर दिया जाता है.

यह सिर्फ़ text पर लागू होता है, न कि topLabel और bottomLabel पर.

string

text के नीचे दिखने वाला टेक्स्ट. हमेशा रैप किया जाता है.

OnClick

यह कार्रवाई तब ट्रिगर होती है, जब उपयोगकर्ता topLabel या bottomLabel पर क्लिक करते हैं.

Button

ऐसा बटन जिस पर क्लिक करके, उपयोगकर्ता कोई कार्रवाई कर सकता है.

SwitchControl

स्विच विजेट, जिस पर क्लिक करके उपयोगकर्ता उसकी स्थिति बदल सकता है और कोई कार्रवाई ट्रिगर कर सकता है.

Icon

टेक्स्ट के बाद दिखने वाला आइकॉन.

पहले से मौजूद और पसंद के मुताबिक आइकॉन का इस्तेमाल किया जा सकता है.

string

वह नाम जिससे फ़ॉर्म इनपुट इवेंट में स्विच विजेट की पहचान की जाती है.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

string

उपयोगकर्ता की ओर से डाली गई वैल्यू, जो फ़ॉर्म इनपुट इवेंट के हिस्से के तौर पर दिखती है.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

bool

true होने पर, स्विच चुना गया है.

Action

स्विच की स्थिति बदलने पर की जाने वाली कार्रवाई. जैसे, कौनसा फ़ंक्शन चलाना है.

ControlType

यूज़र इंटरफ़ेस में स्विच कैसा दिखता है.

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

Action

Google Chat में ऐड-ऑन के लिए, वह कार्रवाई जो डायलॉग बॉक्स को बंद करती है.

Suggestions

string

यह कोई काम न करने वाला स्कीमा फ़ील्ड है, जो सिंटैक्स की जांच के लिए मार्कअप में मौजूद हो सकता है.

string

ग्रिड हेडर में दिखने वाला टेक्स्ट.

GridItem

ग्रिड में दिखाने के लिए आइटम.

BorderStyle

हर ग्रिड आइटम पर लागू होने वाली बॉर्डर स्टाइल.

int32

ग्रिड में दिखाने के लिए कॉलम की संख्या. अगर इस फ़ील्ड की वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है. यह डिफ़ॉल्ट वैल्यू, ग्रिड के दिखने की जगह (डायलॉग बनाम साथी) के हिसाब से अलग-अलग होती है.

OnClick

इस कॉलबैक का इस्तेमाल, हर ग्रिड आइटम करता है. हालांकि, कॉलबैक के पैरामीटर में आइटम की सूची में आइटम के आइडेंटिफ़ायर और इंडेक्स को जोड़ा जाता है.

string

इस ग्रिड आइटम के लिए, उपयोगकर्ता का तय किया गया आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, पैरंट ग्रिड के onClick कॉलबैक पैरामीटर में दिखाया जाता है.

ImageComponent

ग्रिड आइटम में दिखने वाली इमेज.

string

ग्रिड आइटम का टाइटल.

string

ग्रिड आइटम का सबटाइटल.

GridItemLayout

ग्रिड आइटम के लिए इस्तेमाल किया जाने वाला लेआउट.

string

ज़रूरी नहीं. सुलभता के लिए इस्तेमाल किए गए आइकॉन की जानकारी. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू Button दी जाती है. सबसे सही तरीका यह है कि आप आइकॉन के बारे में मददगार जानकारी सेट करें. इससे यह पता चलता है कि आइकॉन क्या दिखाता है और अगर लागू हो, तो यह क्या करता है. उदाहरण के लिए, A user's account portrait या Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

अगर आइकॉन को Button में सेट किया गया है, तो उपयोगकर्ता के बटन पर कर्सर घुमाने पर, altText हेल्पर टेक्स्ट के तौर पर दिखता है. हालांकि, अगर बटन text भी सेट करता है, तो आइकॉन के altText को अनदेखा कर दिया जाता है.

ImageType

इमेज पर लागू किया गया काटने का स्टाइल. कुछ मामलों में, CIRCLE का इस्तेमाल करके इमेज को काटने पर, वह डिवाइस में पहले से मौजूद आइकॉन से बड़ी हो जाती है.

string

Google Workspace में पहले से मौजूद आइकॉन में से कोई एक आइकॉन दिखाएं.

उदाहरण के लिए, हवाई जहाज़ का आइकॉन दिखाने के लिए, AIRPLANE डालें. बस के लिए, BUS की जानकारी दें.

इस्तेमाल किए जा सकने वाले आइकॉन की पूरी सूची के लिए, पहले से मौजूद आइकॉन देखें.

string

एचटीटीपीएस यूआरएल पर होस्ट किया गया कस्टम आइकॉन दिखाएं.

उदाहरण के लिए:

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

इन फ़ाइल टाइप का इस्तेमाल किया जा सकता है: .png और .jpg.

MaterialIcon

Google के मटीरियल आइकॉन में से कोई एक आइकॉन दिखाएं.

उदाहरण के लिए, चेकबॉक्स आइकॉन दिखाने के लिए,

"materialIcon": {
  "name": "check_box"
}

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

string

इमेज को होस्ट करने वाला एचटीटीपीएस यूआरएल.

उदाहरण के लिए:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

OnClick

जब कोई उपयोगकर्ता इमेज पर क्लिक करता है, तो क्लिक से यह कार्रवाई ट्रिगर होती है.

string

इस इमेज का वैकल्पिक टेक्स्ट, जिसका इस्तेमाल सुलभता के लिए किया जाता है.

string

इमेज का यूआरएल.

string

इमेज के लिए सुलभता लेबल.

ImageCropStyle

इमेज पर लागू करने के लिए, काटने का स्टाइल.

BorderStyle

इमेज पर लागू करने के लिए बॉर्डर का स्टाइल.

ImageCropType

काटने का टाइप.

double

अगर क्रॉप टाइप RECTANGLE_CUSTOM है, तो इस्तेमाल किया जाने वाला आसपेक्ट रेशियो.

उदाहरण के लिए, 16:9 आसपेक्ट रेशियो लागू करने का तरीका यहां बताया गया है:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

string

ऐड-ऑन पर वापस जाने के लिए लिंक का यूआरएल.

string

ऐड-ऑन पर वापस जाने के लिए लिंक का टाइटल.

Card

तीसरे पक्ष की सेवा से मिले लिंक की जानकारी दिखाने वाला कार्ड.

string

लिंक की झलक दिखाने वाले स्मार्ट चिप में दिखने वाला टाइटल. अगर इस विकल्प को सेट नहीं किया जाता है, तो स्मार्ट चिप preview_card का हेडर दिखाता है.

string

लिंक की झलक में दिखने वाला टाइटल. अगर यह विकल्प सेट नहीं है, तो लिंक की झलक में preview_card का हेडर दिखता है.

string

Google Material आइकॉन में तय किया गया आइकॉन का नाम, जैसे कि check_box. अमान्य नामों को खारिज कर दिया जाता है और उन्हें खाली स्ट्रिंग से बदल दिया जाता है. इस वजह से, आइकॉन रेंडर नहीं हो पाता.

bool

आइकॉन, भरे हुए के तौर पर रेंडर होता है या नहीं. डिफ़ॉल्ट वैल्यू गलत है.

अलग-अलग आइकॉन की सेटिंग की झलक देखने के लिए, Google फ़ॉन्ट आइकॉन पर जाएं और पसंद के मुताबिक बनाएं में जाकर सेटिंग में बदलाव करें.

int32

आइकॉन के स्ट्रोक की मोटाई. {100, 200, 300, 400, 500, 600, 700} में से कोई एक चुनें. अगर यह एट्रिब्यूट मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू 400 होगी. अगर कोई दूसरी वैल्यू दी गई है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है.

अलग-अलग आइकॉन की सेटिंग की झलक देखने के लिए, Google फ़ॉन्ट आइकॉन पर जाएं और पसंद के मुताबिक बनाएं में जाकर सेटिंग में बदलाव करें.

int32

वज़न और ग्रेड से, किसी सिंबल की चौड़ाई पर असर पड़ता है. ग्रेड में बदलाव करने से, वज़न में बदलाव करने के मुकाबले ज़्यादा असर पड़ता है. साथ ही, इससे सिंबल के साइज़ पर भी थोड़ा असर पड़ता है. {-25, 0, 200} में से कोई एक चुनें. अगर यह एट्रिब्यूट मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू 0 होगी. अगर कोई दूसरी वैल्यू दी गई है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है.

अलग-अलग आइकॉन की सेटिंग की झलक देखने के लिए, Google फ़ॉन्ट आइकॉन पर जाएं और पसंद के मुताबिक बनाएं में जाकर सेटिंग में बदलाव करें.

UpdateWidget

Google Chat में ऐड-ऑन के लिए, कार्ड या डायलॉग में विजेट को अपडेट करता है.

SelectionInputWidgetSuggestions

selectionInput विजेट के लिए, एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू में सुझाए गए आइटम का कलेक्शन. जब मल्टी-सिलेक्ट मेन्यू, अपने आइटम भरने के लिए किसी बाहरी डेटा सोर्स का इस्तेमाल करता है, तो विजेट, मेन्यू में टाइप किए गए शब्दों के आधार पर सुझावों को डाइनैमिक तौर पर भर सकता है. ज़्यादा जानकारी के लिए, Google Chat के उपयोगकर्ताओं से जानकारी इकट्ठा करना लेख पढ़ें.

SelectionItem

चुने जा सकने वाले आइटम की सूची, जो उपयोगकर्ता को मल्टी-सिलेक्ट मेन्यू में टाइप करने के बाद दिखती है.

bool

रूट कार्ड को छोड़कर, सभी कार्ड हटा देता है.

bool

एक कार्ड बाहर निकलता है.

string

यह कार्ड के नाम के साथ, दिए गए कार्ड के ऊपर सभी कार्ड दिखाता है.

Card

कार्ड स्टैक पर कार्ड को पुश करता है.

डेवलपर के लिए झलक: Google Chat में डायलॉग बॉक्स के लिए, डायलॉग बॉक्स खोलता है या उसे अपडेट करता है.

Card

यह टॉप कार्ड को नए कार्ड से अपडेट करता है और भरे गए फ़ॉर्म फ़ील्ड की वैल्यू को सुरक्षित रखता है. अगर फ़ील्ड की वैल्यू मेल नहीं खाती है, तो वैल्यू को हटा दिया जाता है.

डेवलपर के लिए झलक: Google Chat में डायलॉग बॉक्स के लिए, डायलॉग बॉक्स खोलता है या उसे अपडेट करता है.

EndNavigation

Google Chat में ऐड-ऑन के लिए, डायलॉग बॉक्स बंद करता है.

string

सूचना के लिए दिखाया जाने वाला सादा टेक्स्ट, जिसमें एचटीएमएल टैग नहीं होने चाहिए.

Action

अगर इस onClick की वैल्यू दी गई है, तो इसकी वजह से कोई कार्रवाई ट्रिगर होती है.

OpenLink

अगर यह तय किया गया है, तो यह onClick, लिंक खोलने की कार्रवाई को ट्रिगर करता है.

Action

जब किसी कार्रवाई में लिंक खोलना ज़रूरी हो, तब कोई ऐड-ऑन इस कार्रवाई को ट्रिगर करता है. यह ऊपर दिए गए open_link से अलग है, क्योंकि लिंक पाने के लिए इसे सर्वर से बातचीत करनी पड़ती है. इसलिए, लिंक खोलने की कार्रवाई का जवाब मिलने से पहले, वेब क्लाइंट को कुछ तैयारी करनी होगी.

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

Card

अगर क्लिक करने के बाद कोई नया कार्ड दिखाना है, तो कार्ड स्टैक में एक नया कार्ड जोड़ दिया जाता है.

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

OverflowMenu

अगर तय किया गया है, तो यह onClick ओवरफ़्लो मेन्यू खोलता है.

string

खोला जाने वाला यूआरएल.

OpenAs

लिंक खोलने का तरीका.

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

OnClose

क्लाइंट, लिंक खोलने के बाद उसे याद रखता है या विंडो बंद होने तक उसे देखता है.

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

OverflowMenuItem

ज़रूरी है. मेन्यू के विकल्पों की सूची.

Icon

टेक्स्ट के सामने दिखने वाला आइकॉन.

string

ज़रूरी है. वह टेक्स्ट जिससे उपयोगकर्ताओं को आइटम की पहचान या जानकारी मिलती है.

OnClick

ज़रूरी है. मेन्यू का कोई विकल्प चुनने पर होने वाली कार्रवाई. इस OnClick में OverflowMenu नहीं हो सकता. कोई भी तय किया गया OverflowMenu हटा दिया जाता है और मेन्यू आइटम बंद कर दिया जाता है.

bool

मेन्यू विकल्प बंद है या नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है.

Action

वह कार्रवाई जिसका इस्तेमाल ऐड-ऑन, यूज़र इंटरफ़ेस (यूआई) को अपडेट करने के लिए कर सकते हैं.

डेवलपर के लिए झलक: Google Chat में ऐड-ऑन.

HostAppActionMarkup

अलग-अलग होस्ट ऐप्लिकेशन से मैनेज की जाने वाली कार्रवाइयां.

string

यह कोई काम न करने वाला स्कीमा फ़ील्ड है, जो सिंटैक्स की जांच के लिए मार्कअप में मौजूद हो सकता है.

Navigation

किसी कार्ड को पुश, पॉप या अपडेट करता है.

डेवलपर के लिए झलक: Google Chat में ऐड-ऑन.

OpenLink

टारगेट लिंक को नए टैब या पॉप-अप विंडो में खोलता है.

Notification

जब कोई उपयोगकर्ता किसी कार्ड से इंटरैक्ट करता है, तो होस्ट Google Workspace ऐप्लिकेशन में सूचना दिखाता है.

डेवलपर के लिए झलक: Google Chat में ऐड-ऑन के लिए, उपयोगकर्ताओं के डायलॉग बॉक्स को सबमिट करने और बंद करने पर सूचना दिखाता है.

LinkPreview

यह सुविधा Google Docs, Google Sheets, और Google Slides में उपलब्ध है. स्मार्ट चिप और कार्ड की मदद से लिंक की झलक दिखाता है. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

Link

Google Docs में उपलब्ध है. तीसरे पक्ष के संसाधन से लिंक दिखाता है और उसे होस्ट ऐप्लिकेशन में स्मार्ट चिप में बदलता है. एक आइटम वाले ऑब्जेक्ट के कलेक्शन के तौर पर फ़ॉर्मैट किया गया.

ज़्यादा जानकारी के लिए, @ मेन्यू से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.

ModifyCard

Google Chat में ऐड-ऑन के लिए, उपयोगकर्ता के इंटरैक्शन के आधार पर कार्ड अपडेट करता है. ऐरे में सिर्फ़ एक ऑब्जेक्ट होना चाहिए.

string

ज़रूरी है. वह नाम जो फ़ॉर्म इनपुट इवेंट में, चुने गए इनपुट की पहचान करता है.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

string

यूज़र इंटरफ़ेस में, चुनने के लिए दिए गए इनपुट फ़ील्ड के ऊपर दिखने वाला टेक्स्ट.

ऐसा टेक्स्ट डालें जिससे उपयोगकर्ता को आपके ऐप्लिकेशन के लिए ज़रूरी जानकारी डालने में मदद मिले. उदाहरण के लिए, अगर उपयोगकर्ता ड्रॉप-डाउन मेन्यू से किसी वर्क टिकट की प्राथमिकता चुन रहे हैं, तो लेबल "प्राथमिकता" या "प्राथमिकता चुनें" हो सकता है.

SelectionType

SelectionInput विजेट में उपयोगकर्ताओं को दिखाए जाने वाले आइटम का टाइप. चुनने के तरीके, अलग-अलग तरह के इंटरैक्शन के साथ काम करते हैं. उदाहरण के लिए, उपयोगकर्ता एक या उससे ज़्यादा चेकबॉक्स चुन सकते हैं, लेकिन वे ड्रॉपडाउन मेन्यू से सिर्फ़ एक वैल्यू चुन सकते हैं.

SelectionItem

चुने जा सकने वाले आइटम का कलेक्शन. उदाहरण के लिए, रेडियो बटन या चेकबॉक्स का ऐरे. इसमें ज़्यादा से ज़्यादा 100 आइटम जोड़े जा सकते हैं.

Action

अगर यह विकल्प चुना गया है, तो चुने गए विकल्प में बदलाव होने पर फ़ॉर्म सबमिट हो जाता है. अगर इसकी जानकारी नहीं दी गई है, तो आपको फ़ॉर्म सबमिट करने वाला एक अलग बटन तय करना होगा.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

int32

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

int32

एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, टेक्स्ट के उन वर्णों की संख्या जो उपयोगकर्ता, मेन्यू में आइटम चुनने के सुझाव मिलने से पहले डालता है.

अगर यह सेट नहीं है, तो मल्टी-सिलेक्ट मेन्यू इन डिफ़ॉल्ट वैल्यू का इस्तेमाल करता है:

• अगर मेन्यू में SelectionInput आइटम के स्टैटिक कलेक्शन का इस्तेमाल किया जाता है, तो डिफ़ॉल्ट रूप से 0 वर्ण दिखते हैं. साथ ही, आइटम तुरंत कलेक्शन से पॉप्युलेट हो जाते हैं.
• अगर मेन्यू में डाइनैमिक डेटा सोर्स (multi_select_data_source) का इस्तेमाल किया जाता है, तो सुझाए गए आइटम दिखाने के लिए, डेटा सोर्स से क्वेरी करने से पहले, डिफ़ॉल्ट रूप से तीन वर्ण दिखते हैं.

Action

कोई बाहरी डेटा सोर्स, जैसे कि रिलेशनल डेटाबेस.

PlatformDataSource

Google Workspace का डेटा सोर्स.

CommonDataSource

Google Workspace के सभी ऐप्लिकेशन के साथ शेयर किया जाने वाला डेटा सोर्स. जैसे, Google Workspace संगठन के उपयोगकर्ता.

HostAppDataSourceMarkup

Google Workspace के होस्ट ऐप्लिकेशन के लिए खास डेटा सोर्स, जैसे कि Google Chat में मौजूद स्पेसेज़.

यह फ़ील्ड, Google API क्लाइंट लाइब्रेरी के साथ काम करता है. हालांकि, यह Cloud क्लाइंट लाइब्रेरी में उपलब्ध नहीं है. ज़्यादा जानने के लिए, क्लाइंट लाइब्रेरी इंस्टॉल करना लेख पढ़ें.

string

वह टेक्स्ट जिससे उपयोगकर्ताओं को आइटम की पहचान या जानकारी मिलती है.

string

इस आइटम से जुड़ी वैल्यू. क्लाइंट को इसका इस्तेमाल, फ़ॉर्म इनपुट वैल्यू के तौर पर करना चाहिए.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

bool

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

string

एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, आइटम के text फ़ील्ड के बगल में दिखाए गए आइकॉन का यूआरएल. PNG और JPEG फ़ाइलों के साथ काम करता है. यह HTTPS यूआरएल होना चाहिए. उदाहरण के लिए, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

string

एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, आइटम के text फ़ील्ड के नीचे दिखने वाला टेक्स्ट ब्यौरा या लेबल.

RenderActions

रेंडर करने के निर्देशों का एक सेट, जो कार्ड को कोई कार्रवाई करने के लिए कहता है और/या ऐड-ऑन होस्ट ऐप्लिकेशन को ऐप्लिकेशन के हिसाब से कोई कार्रवाई करने के लिए कहता है.

bool

कार्ड की स्थिति में बदलाव हुआ है या नहीं और मौजूदा कार्ड में मौजूद डेटा पुराना है या नहीं.

string

यह कोई काम न करने वाला स्कीमा फ़ील्ड है, जो सिंटैक्स की जांच के लिए मार्कअप में मौजूद हो सकता है.

SuggestionItem

टेक्स्ट इनपुट फ़ील्ड में, अपने-आप पूरा होने वाले सुझावों के लिए इस्तेमाल किए जाने वाले सुझावों की सूची.

string

टेक्स्ट इनपुट फ़ील्ड में सुझाए गए इनपुट की वैल्यू. यह वही है जो उपयोगकर्ता खुद डालते हैं.

string

वह नाम जिससे फ़ॉर्म इनपुट इवेंट में टेक्स्ट इनपुट की पहचान की जाती है.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

string

यूज़र इंटरफ़ेस में टेक्स्ट इनपुट फ़ील्ड के ऊपर दिखने वाला टेक्स्ट.

ऐसा टेक्स्ट डालें जिससे उपयोगकर्ता को आपके ऐप्लिकेशन के लिए ज़रूरी जानकारी डालने में मदद मिले. उदाहरण के लिए, अगर आपको किसी व्यक्ति का नाम पूछना है, लेकिन आपको खास तौर पर उसका सरनेम चाहिए, तो name के बजाय surname लिखें.

अगर hintText की वैल्यू नहीं दी गई है, तो इसका इस्तेमाल करना ज़रूरी है. हालांकि, ऐसा करना ज़रूरी नहीं है.

string

टेक्स्ट इनपुट फ़ील्ड के नीचे दिखने वाला टेक्स्ट, उपयोगकर्ताओं को किसी खास वैल्यू डालने के लिए कहकर उनकी मदद करता है. यह टेक्स्ट हमेशा दिखता है.

अगर label की वैल्यू नहीं दी गई है, तो इसका इस्तेमाल करना ज़रूरी है. हालांकि, ऐसा करना ज़रूरी नहीं है.

string

उपयोगकर्ता की ओर से डाली गई वैल्यू, जो फ़ॉर्म इनपुट इवेंट के हिस्से के तौर पर दिखती है.

फ़ॉर्म इनपुट के साथ काम करने के बारे में जानने के लिए, फ़ॉर्म का डेटा पाना लेख पढ़ें.

Type

यूज़र इंटरफ़ेस में टेक्स्ट इनपुट फ़ील्ड कैसा दिखता है. उदाहरण के लिए, फ़ील्ड एक लाइन का है या कई लाइन का.

Action

टेक्स्ट इनपुट फ़ील्ड में बदलाव होने पर क्या करना चाहिए. उदाहरण के लिए, कोई उपयोगकर्ता फ़ील्ड में टेक्स्ट जोड़ रहा है या मिटा रहा है.

कार्रवाइयों के उदाहरणों में, Google Chat में कस्टम फ़ंक्शन चलाना या डायलॉग बॉक्स खोलना शामिल है.

Suggestions

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

उदाहरण के लिए, प्रोग्रामिंग भाषा के लिए टेक्स्ट इनपुट फ़ील्ड में, Java, JavaScript, Python, और C++ के सुझाव मिल सकते हैं. जब उपयोगकर्ता Jav टाइप करना शुरू करते हैं, तो सुझावों की सूची फ़िल्टर हो जाती है, ताकि सिर्फ़ Java और JavaScript दिखें.

सुझाई गई वैल्यू से, उपयोगकर्ताओं को ऐसी वैल्यू डालने में मदद मिलती है जो आपके ऐप्लिकेशन के काम की हो. JavaScript का रेफ़रंस देते समय, कुछ उपयोगकर्ता javascript डाल सकते हैं और कुछ java script. JavaScript का सुझाव देने से, यह तय किया जा सकता है कि उपयोगकर्ता आपके ऐप्लिकेशन से कैसे इंटरैक्ट करें.

अगर TextInput.type की वैल्यू तय की गई है, तो यह हमेशा SINGLE_LINE होती है. भले ही, इसे MULTIPLE_LINE पर सेट किया गया हो.

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

Action

ज़रूरी नहीं. यह तय करें कि जब टेक्स्ट इनपुट फ़ील्ड, उससे इंटरैक्ट करने वाले उपयोगकर्ताओं को सुझाव देता है, तो क्या कार्रवाई की जाए.

अगर कोई वैल्यू नहीं दी गई है, तो सुझाव initialSuggestions सेट करता है और क्लाइंट उन्हें प्रोसेस करता है.

अगर कोई कार्रवाई तय की गई है, तो ऐप्लिकेशन यहां बताई गई कार्रवाई करता है. जैसे, कोई कस्टम फ़ंक्शन चलाना.

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

Validation

इस टेक्स्ट फ़ील्ड के लिए, इनपुट फ़ॉर्मैट की पुष्टि करने की ज़रूरी शर्तें बताएं.

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

string

टेक्स्ट इनपुट फ़ील्ड में, फ़ील्ड खाली होने पर दिखने वाला टेक्स्ट. उपयोगकर्ताओं को कोई वैल्यू डालने के लिए कहने के लिए, इस टेक्स्ट का इस्तेमाल करें. उदाहरण के लिए, Enter a number from 0 to 100.

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

string

विजेट में दिखने वाला टेक्स्ट.

int32

विजेट में दिखने वाली टेक्स्ट की ज़्यादा से ज़्यादा लाइनों की संख्या. अगर टेक्स्ट में लाइनों की तय सीमा से ज़्यादा लाइनें हैं, तो ज़्यादा कॉन्टेंट को ज़्यादा दिखाएं बटन के पीछे छिपा दिया जाता है. अगर टेक्स्ट, तय की गई ज़्यादा से ज़्यादा लाइनों के बराबर या उससे कम है, तो ज़्यादा दिखाएं बटन नहीं दिखता.

डिफ़ॉल्ट वैल्यू 0 होती है. इस मामले में, पूरा कॉन्टेक्स्ट दिखता है. नेगेटिव वैल्यू को अनदेखा कर दिया जाता है.

int32

टेक्स्ट इनपुट विजेट के लिए, वर्णों की सीमा तय करें. ध्यान दें कि इसका इस्तेमाल सिर्फ़ टेक्स्ट इनपुट के लिए किया जाता है. अन्य विजेट के लिए इसका इस्तेमाल नहीं किया जाता.

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

InputType

इनपुट विजेट का टाइप बताएं.

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

HorizontalAlignment

इससे यह तय होता है कि विजेट, कॉलम के बाएं, दाएं या बीच में अलाइन हों.

TextParagraph

टेक्स्ट पैराग्राफ दिखाता है. इसमें एचटीएमएल फ़ॉर्मैट में लिखा गया आसान टेक्स्ट इस्तेमाल किया जा सकता है. टेक्स्ट को फ़ॉर्मैट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन में टेक्स्ट को फ़ॉर्मैट करना और Google Workspace के ऐड-ऑन में टेक्स्ट को फ़ॉर्मैट करना लेख पढ़ें.

उदाहरण के लिए, यह JSON बोल्ड टेक्स्ट बनाता है:

"textParagraph": {
  "text": "  <b>bold text</b>"
}

Image

इमेज दिखाता है.

उदाहरण के लिए, यहां दिया गया JSON, वैकल्पिक टेक्स्ट वाली इमेज बनाता है:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

DecoratedText

सजाए गए टेक्स्ट आइटम को दिखाता है.

उदाहरण के लिए, यहां दिया गया JSON, ईमेल पता दिखाने वाला सजा हुआ टेक्स्ट विजेट बनाता है:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

ButtonList

बटन की सूची.

उदाहरण के लिए, यहां दिया गया JSON दो बटन बनाता है. पहला, नीले रंग का टेक्स्ट बटन है और दूसरा, लिंक खोलने वाला इमेज बटन है:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

TextInput

एक टेक्स्ट बॉक्स दिखाता है जिसमें उपयोगकर्ता टाइप कर सकते हैं.

उदाहरण के लिए, यह JSON किसी ईमेल पते के लिए टेक्स्ट इनपुट बनाता है:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

एक और उदाहरण के तौर पर, यहां दिया गया JSON, स्टैटिक सुझावों के साथ प्रोग्रामिंग भाषा के लिए टेक्स्ट इनपुट बनाता है:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

SelectionInput

यह एक चुनने वाला कंट्रोल दिखाता है, जिसकी मदद से उपयोगकर्ता आइटम चुन सकते हैं. चुनने के लिए कंट्रोल, चेकबॉक्स, रेडियो बटन, स्विच या ड्रॉपडाउन मेन्यू हो सकते हैं.

उदाहरण के लिए, यहां दिया गया JSON, एक ड्रॉपडाउन मेन्यू बनाता है. इसकी मदद से, उपयोगकर्ता साइज़ चुन सकते हैं:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

DateTimePicker

एक विजेट दिखाता है, जिसकी मदद से उपयोगकर्ता तारीख, समय या तारीख और समय डाल सकते हैं.

उदाहरण के लिए, नीचे दिया गया JSON, अपॉइंटमेंट शेड्यूल करने के लिए तारीख और समय चुनने वाला टूल बनाता है:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}

Divider

विजेट के बीच हॉरिज़ॉन्टल लाइन डिवाइडर दिखाता है.

उदाहरण के लिए, यह JSON एक डिवाइडर बनाता है:

"divider": {
}

Grid

आइटम के कलेक्शन वाला ग्रिड दिखाता है.

ग्रिड में, किसी भी संख्या में कॉलम और आइटम जोड़े जा सकते हैं. पंक्तियों की संख्या, आइटम की ऊपरी सीमा को कॉलम की संख्या से भाग देने पर तय होती है. 10 आइटम और दो कॉलम वाले ग्रिड में पांच लाइनें होती हैं. 11 आइटम और दो कॉलम वाले ग्रिड में छह पंक्तियां होती हैं.

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

उदाहरण के लिए, यहां दिया गया JSON, एक आइटम के साथ दो कॉलम वाली ग्रिड बनाता है:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

Columns

ज़्यादा से ज़्यादा दो कॉलम दिखाता है.

दो से ज़्यादा कॉलम शामिल करने या पंक्तियों का इस्तेमाल करने के लिए, Grid विजेट का इस्तेमाल करें.

उदाहरण के लिए, यहां दिया गया JSON दो कॉलम बनाता है, जिनमें से हर कॉलम में टेक्स्ट पैराग्राफ़ होते हैं:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

Carousel

कैरसेल में नेस्ट किए गए विजेट का कलेक्शन होता है. उदाहरण के लिए, यह कैरसेल का JSON वर्शन है, जिसमें दो टेक्स्ट पैराग्राफ़ हैं.

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}

ChipList

चिप की सूची.

उदाहरण के लिए, यहां दिया गया JSON दो चिप बनाता है. पहला एक टेक्स्ट चिप है और दूसरा एक आइकॉन चिप है, जो लिंक खोलता है:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}