Package google.apps.card.v1

इंडेक्स

कार्रवाई

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

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

फ़ील्ड
function

string

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

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

parameters[]

ActionParameter

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

loadIndicator

LoadIndicator

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

persistValues

bool

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

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

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

interaction

Interaction

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

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

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

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

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

requiredWidgets[]

string

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

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

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

allWidgetsAreRequired

bool

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

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

ActionParameter

ऐक्शन का तरीका शुरू करने पर, दिए जाने वाले स्ट्रिंग पैरामीटर की सूची. उदाहरण के लिए, स्नूज़ करने के लिए तीन बटन: अभी स्नूज़ करें, एक दिन के लिए स्नूज़ करें या अगले हफ़्ते के लिए स्नूज़ करें. action method = snooze() का इस्तेमाल करके, स्ट्रिंग पैरामीटर की सूची में स्नूज़ टाइप और स्नूज़ का समय पास किया जा सकता है.

ज़्यादा जानने के लिए, CommonEventObject देखें.

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

फ़ील्ड
key

string

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

value

string

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

बातचीत

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

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

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

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

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

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

Enums
INTERACTION_UNSPECIFIED डिफ़ॉल्ट मान. action सामान्य तरीके से काम करता है.
OPEN_DIALOG

यह एक डायलॉग खोलता है. यह एक विंडो वाला, कार्ड-आधारित इंटरफ़ेस होता है. Chat ऐप्लिकेशन, उपयोगकर्ताओं के साथ इंटरैक्ट करने के लिए इसका इस्तेमाल करते हैं.

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

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

LoadIndicator

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

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

Enums
SPINNER कॉन्टेंट लोड होने का पता चलने के लिए, स्पिनर दिखाता है.
NONE कुछ भी नहीं दिखता.

BorderStyle

कार्ड या विजेट के बॉर्डर के लिए स्टाइल के विकल्प. इनमें बॉर्डर का टाइप और रंग शामिल है.

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

फ़ील्ड
type

BorderType

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

strokeColor

Color

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

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

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

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

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

cornerRadius

int32

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

BorderType

विजेट पर लागू की गई बॉर्डर टाइप दिखाता है.

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

Enums
BORDER_TYPE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
NO_BORDER डिफ़ॉल्ट मान. कोई बॉर्डर नहीं.
STROKE आउटलाइन.

बटन

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

किसी इमेज को क्लिक किए जा सकने वाले बटन में बदलने के लिए, Image (ImageComponent नहीं) डालें और onClick कार्रवाई सेट करें.

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

फ़ील्ड
text

string

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

icon

Icon

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

color

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

OnClick

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

disabled

bool

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

altText

string

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

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

type

Type

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

टाइप

ज़रूरी नहीं. बटन का टाइप. अगर color फ़ील्ड सेट है, तो type को FILLED पर सेट किया जाता है.

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

Enums
TYPE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
OUTLINED आउटलाइन वाले बटन, सामान्य बटन होते हैं. आम तौर पर, इनमें ऐसी कार्रवाइयां शामिल होती हैं जो ज़रूरी हैं, लेकिन Chat ऐप्लिकेशन या ऐड-ऑन में मुख्य कार्रवाई नहीं होती हैं.
FILLED भरे हुए बटन का कंटेनर एक ही रंग का होता है. यह विज़ुअल तौर पर सबसे ज़्यादा असरदार होता है. साथ ही, इसका सुझाव चैट ऐप्लिकेशन या ऐड-ऑन में, अहम और मुख्य ऐक्शन के लिए दिया जाता है.
FILLED_TONAL भरा हुआ टोन वाला बटन, भरे हुए और आउटलाइन वाले बटन के बीच का विकल्प है. ये ऐसे कॉन्टेक्स्ट में काम के होते हैं जहां कम प्राथमिकता वाले बटन को, आउटलाइन बटन के मुकाबले थोड़ा ज़्यादा ध्यान देने की ज़रूरत होती है.
BORDERLESS बटन की डिफ़ॉल्ट स्थिति में, कोई इनविज़िबल कंटेनर नहीं होना चाहिए. इसका इस्तेमाल अक्सर सबसे कम प्राथमिकता वाली कार्रवाइयों के लिए किया जाता है. खास तौर पर, कई विकल्पों को दिखाते समय.

ButtonList

बटनों की सूची, जो हॉरिज़ॉन्टल तौर पर दिखाई गई है. Google Chat ऐप्लिकेशन में बटन जोड़ने का उदाहरण देखने के लिए, बटन जोड़ना लेख पढ़ें.

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

फ़ील्ड
buttons[]

Button

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

कार्ड

Google Chat मैसेज या Google Workspace ऐड-ऑन में दिखने वाला कार्ड इंटरफ़ेस.

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

कार्ड बिल्डर की मदद से कार्ड डिज़ाइन करना और उनकी झलक देखना.

कार्ड बिल्डर खोलना

कार्ड बनाने का तरीका जानने के लिए, यहां दिए गए दस्तावेज़ देखें:

ध्यान दें: हर कार्ड में ज़्यादा से ज़्यादा 100 विजेट जोड़े जा सकते हैं. इस सीमा से ज़्यादा विजेट जोड़ने पर, उन्हें अनदेखा कर दिया जाता है. यह सीमा, Google Chat ऐप्लिकेशन में कार्ड मैसेज और डायलॉग, दोनों पर लागू होती है. साथ ही, Google Workspace के ऐड-ऑन में मौजूद कार्ड पर भी लागू होती है.

उदाहरण: Google Chat ऐप्लिकेशन के लिए कार्ड मैसेज

संपर्क कार्ड का उदाहरण

Google Chat में कार्ड मैसेज का सैंपल बनाने के लिए, इस JSON का इस्तेमाल करें:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
फ़ील्ड
header

CardHeader

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

sections[]

Section

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

sectionDividerStyle

DividerStyle

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

cardActions[]

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"
      }
    }
  }
]
name

string

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

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

fixedFooter

CardFixedFooter

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

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

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

displayStyle

DisplayStyle

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

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

peekCardHeader

CardHeader

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

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

CardAction

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

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

फ़ील्ड
actionLabel

string

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

onClick

OnClick

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

CardFixedFooter

कार्ड में सबसे नीचे दिखने वाला फ़ुटर, जो हमेशा दिखता है.

primaryButton या secondaryButton की जानकारी दिए बिना fixedFooter सेट करने पर गड़बड़ी होती है.

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

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

फ़ील्ड
primaryButton

Button

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

secondaryButton

Button

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

CardHeader

कार्ड हेडर दिखाता है. Google Chat ऐप्लिकेशन में, हेडर जोड़ने का उदाहरण देखने के लिए, हेडर जोड़ना लेख पढ़ें.

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

फ़ील्ड
title

string

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

subtitle

string

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

imageType

ImageType

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

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

imageUrl

string

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

imageAltText

string

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

DisplayStyle

Google Workspace के ऐड-ऑन में, यह तय करता है कि कार्ड कैसे दिखेगा.

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

Enums
DISPLAY_STYLE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
PEEK कार्ड का हेडर, साइडबार में सबसे नीचे दिखता है. यह स्टैक के मौजूदा टॉप कार्ड को कुछ हद तक कवर करता है. हेडर पर क्लिक करने से, कार्ड स्टैक में कार्ड पॉप अप हो जाता है. अगर कार्ड में कोई हेडर नहीं है, तो इसके बजाय जनरेट किया गया हेडर इस्तेमाल किया जाता है.
REPLACE डिफ़ॉल्ट मान. कार्ड को दिखाने के लिए, कार्ड स्टैक में सबसे ऊपर मौजूद कार्ड के व्यू को बदला जाता है.

DividerStyle

कार्ड के लिए डिवाइडर का स्टाइल. फ़िलहाल, इसका इस्तेमाल सिर्फ़ कार्ड के सेक्शन के बीच डिवाइडर के तौर पर किया जाता है.

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

Enums
DIVIDER_STYLE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
SOLID_DIVIDER डिफ़ॉल्ट विकल्प. सॉलिड डिवाइडर रेंडर करें.
NO_DIVIDER अगर यह सेट है, तो कोई डिवाइडर रेंडर नहीं किया जाता. इस स्टाइल में, लेआउट से डिवाइडर पूरी तरह हट जाता है. इसका मतलब है कि आपने कोई डिवाइडर नहीं जोड़ा है.

NestedWidget

विजेट की सूची, जिसे किसी लेआउट में दिखाया जा सकता है, जैसे कि CarouselCard. यह सुविधा, Google Chat ऐप्लिकेशन के लिए उपलब्ध है. हालांकि, यह Google Workspace के ऐड-ऑन के लिए उपलब्ध नहीं है.

फ़ील्ड

यूनियन फ़ील्ड data.

data इनमें से कोई एक हो सकता है:

textParagraph

TextParagraph

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

buttonList

ButtonList

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

image

Image

इमेज विजेट.

सेक्शन

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

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

फ़ील्ड
header

string

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

widgets[]

Widget

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

collapsible

bool

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

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

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

uncollapsibleWidgetsCount

int32

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

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

collapseControl

CollapseControl

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

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

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

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Third text paragraph in carousel",
          }
        }
      ]
    }
  ]
}

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

फ़ील्ड
carouselCards[]

CarouselCard

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

CarouselCard

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

फ़ील्ड
widgets[]

NestedWidget

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

footerWidgets[]

NestedWidget

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

चिप

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

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

फ़ील्ड
icon

Icon

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

label

string

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

onClick

OnClick

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

enabled
(deprecated)

bool

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

disabled

bool

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

altText

string

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

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

ChipList

हॉरिज़ॉन्टल तौर पर लगाई गई चिप की सूची, जिसे हॉरिज़ॉन्टल तौर पर स्क्रोल किया जा सकता है या अगली लाइन में रैप किया जा सकता है.

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

फ़ील्ड
layout

Layout

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

chips[]

Chip

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

लेआउट

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

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

CollapseControl

बड़ा और छोटा करने वाले कंट्रोल को दिखाता है.

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

फ़ील्ड
horizontalAlignment

HorizontalAlignment

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

expandButton

Button

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

collapseButton

Button

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

कॉलम

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

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

कॉलम एक साथ दिखते हैं. HorizontalSizeStyle फ़ील्ड का इस्तेमाल करके, हर कॉलम की चौड़ाई को पसंद के मुताबिक बनाया जा सकता है. अगर उपयोगकर्ता की स्क्रीन की चौड़ाई बहुत कम है, तो दूसरा कॉलम पहले कॉलम के नीचे दिखता है:

  • वेब पर, अगर स्क्रीन की चौड़ाई 480 पिक्सल से कम या उसके बराबर है, तो दूसरा कॉलम रैप हो जाता है.
  • iOS डिवाइसों पर, अगर स्क्रीन की चौड़ाई 300 पॉइंट से कम या उसके बराबर है, तो दूसरा कॉलम रैप हो जाता है.
  • Android डिवाइसों पर, अगर स्क्रीन की चौड़ाई 320 डीपी से कम या उसके बराबर है, तो दूसरा कॉलम रैप हो जाता है.

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

Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है. कॉलम के साथ काम करने वाले ऐड-ऑन यूज़र इंटरफ़ेस में ये शामिल हैं:

  • यह डायलॉग तब दिखता है, जब उपयोगकर्ता किसी ईमेल ड्राफ़्ट से ऐड-ऑन खोलते हैं.
  • Google Calendar इवेंट में, अटैचमेंट जोड़ें मेन्यू से ऐड-ऑन खोलने पर दिखने वाला डायलॉग.
फ़ील्ड
columnItems[]

Column

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

कॉलम

कॉलम.

Google Workspace के ऐड-ऑन और Chat के ऐप्लिकेशन

फ़ील्ड
horizontalSizeStyle

HorizontalSizeStyle

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

horizontalAlignment

HorizontalAlignment

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

verticalAlignment

VerticalAlignment

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

widgets[]

Widgets

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

HorizontalSizeStyle

इससे यह तय होता है कि कोई कॉलम, कार्ड की चौड़ाई को कैसे भरता है. हर कॉलम की चौड़ाई, HorizontalSizeStyle और कॉलम में मौजूद विजेट, दोनों पर निर्भर करती है.

Google Workspace के ऐड-ऑन और Chat के ऐप्लिकेशन

Enums
HORIZONTAL_SIZE_STYLE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
FILL_AVAILABLE_SPACE डिफ़ॉल्ट मान. कॉलम, कार्ड की चौड़ाई के 70% तक उपलब्ध जगह को भर देता है. अगर दोनों कॉलम FILL_AVAILABLE_SPACE पर सेट हैं, तो हर कॉलम में 50% जगह भर जाएगी.
FILL_MINIMUM_SPACE कॉलम, कार्ड की चौड़ाई के 30% से ज़्यादा और कम से कम जगह लेता है.

VerticalAlignment

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

Google Workspace के ऐड-ऑन और Chat के ऐप्लिकेशन

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
CENTER डिफ़ॉल्ट मान. विजेट को कॉलम के बीच में अलाइन करता है.
TOP विजेट को कॉलम के सबसे ऊपर अलाइन करता है.
BOTTOM विजेट को कॉलम में सबसे नीचे अलाइन करता है.

विजेट

कॉलम में शामिल किए जा सकने वाले विजेट.

Google Workspace के ऐड-ऑन और Chat के ऐप्लिकेशन

फ़ील्ड

यूनियन फ़ील्ड data.

data इनमें से कोई एक हो सकता है:

textParagraph

TextParagraph

TextParagraph विजेट.

image

Image

Image विजेट.

decoratedText

DecoratedText

DecoratedText विजेट.

buttonList

ButtonList

ButtonList विजेट.

textInput

TextInput

TextInput विजेट.

selectionInput

SelectionInput

SelectionInput विजेट.

dateTimePicker

DateTimePicker

DateTimePicker विजेट.

chipList

ChipList

ChipList विजेट.

DataActions

Google Workspace का डेटा अपडेट करने वाली ऐड-ऑन कार्रवाई.

फ़ील्ड
hostAppDataAction

HostAppDataActionMarkup

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

DateTimePicker

इसकी मदद से, उपयोगकर्ता तारीख, समय या तारीख और समय, दोनों डाल सकते हैं. फ़ॉर्म सबमिशन की पुष्टि करने की सुविधा के साथ काम करता है. जब Action.all_widgets_are_required को true पर सेट किया जाता है या Action.required_widgets में यह विजेट तय किया जाता है, तो कोई वैल्यू चुनने तक सबमिशन ऐक्शन ब्लॉक रहता है. Google Chat ऐप्लिकेशन में, उपयोगकर्ता को तारीख और समय चुनने की अनुमति दें देखें.

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

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

फ़ील्ड
name

string

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

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

label

string

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

type

DateTimePickerType

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

valueMsEpoch

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) का इस्तेमाल करें.
timezoneOffsetDate

int32

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

onChangeAction

Action

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

DateTimePickerType

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

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

Enums
DATE_AND_TIME उपयोगकर्ता तारीख और समय डालते हैं.
DATE_ONLY उपयोगकर्ता कोई तारीख डालते हैं.
TIME_ONLY उपयोगकर्ता कोई समय डालते हैं.

DecoratedText

यह एक ऐसा विजेट है जो टेक्स्ट के साथ वैकल्पिक सजावट दिखाता है. जैसे, टेक्स्ट के ऊपर या नीचे लेबल, टेक्स्ट के सामने आइकॉन, चुनने के लिए विजेट या टेक्स्ट के बाद बटन. Google Chat ऐप्लिकेशन में उदाहरण के लिए, सजावटी टेक्स्ट के साथ टेक्स्ट दिखाना देखें.

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

फ़ील्ड
icon
(deprecated)

Icon

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

startIcon

Icon

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

topLabel

string

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

text

string

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

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

wrapText

bool

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

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

bottomLabel

string

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

onClick

OnClick

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

यूनियन फ़ील्ड control. decoratedText विजेट में टेक्स्ट की दाईं ओर दिखने वाला बटन, स्विच, चेकबॉक्स या इमेज. control इनमें से कोई एक हो सकता है:
button

Button

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

switchControl

SwitchControl

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

endIcon

Icon

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

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

SwitchControl

decoratedText विजेट में टॉगल-स्टाइल स्विच या चेकबॉक्स.

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

यह सुविधा सिर्फ़ decoratedText विजेट में काम करती है.

फ़ील्ड
name

string

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

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

value

string

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

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

selected

bool

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

onChangeAction

Action

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

controlType

ControlType

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

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

ControlType

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

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

Enums
SWITCH टॉगल-स्टाइल स्विच.
CHECKBOX CHECK_BOX के पक्ष में, अब काम नहीं करता.
CHECK_BOX चेकबॉक्स.

डिवाइडर

इस टाइप में कोई फ़ील्ड नहीं है.

विजेट के बीच डिवाइडर को हॉरिज़ॉन्टल लाइन के तौर पर दिखाता है. Google Chat ऐप्लिकेशन में उदाहरण के लिए, विजेट के बीच हॉरिज़ॉन्टल डिवाइडर जोड़ना देखें.

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

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

"divider": {}

EndNavigation

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

फ़ील्ड
action

Action

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

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

कार्रवाई

Google Chat में ऐड-ऑन के लिए, EndNavigation के लिए कार्रवाइयां.

Enums
ACTION_UNSPECIFIED कार्रवाई की जानकारी नहीं दी गई है.
CLOSE_DIALOG डायलॉग बॉक्स बंद करता है.
CLOSE_DIALOG_AND_EXECUTE डायलॉग बॉक्स को बंद करता है और उस कार्ड को रीफ़्रेश करता है जिसकी वजह से डायलॉग बॉक्स खुला था.

GetAutocompletionResponse

ऑटोकंप्लीट कंटेनर पाने का जवाब. इसमें टेक्स्ट फ़ील्ड के लिए ऑटोकंप्लीट आइटम दिखाने के लिए ज़रूरी एलिमेंट शामिल होते हैं.

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

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
फ़ील्ड
autoComplete

Suggestions

schema

string

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

ग्रिड

आइटम के कलेक्शन वाला ग्रिड दिखाता है. आइटम में सिर्फ़ टेक्स्ट या इमेज शामिल की जा सकती हैं. रिस्पॉन्सिव कॉलम के लिए या टेक्स्ट या इमेज के अलावा और भी चीज़ें शामिल करने के लिए, Columns का इस्तेमाल करें. Google Chat ऐप्लिकेशन में उदाहरण के लिए, आइटम के कलेक्शन के साथ ग्रिड दिखाना देखें.

ग्रिड में, किसी भी संख्या में कॉलम और आइटम जोड़े जा सकते हैं. पंक्तियों की संख्या, आइटम को कॉलम से भाग देने पर तय होती है. 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"
    }
  }
}
फ़ील्ड
title

string

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

items[]

GridItem

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

borderStyle

BorderStyle

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

columnCount

int32

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

onClick

OnClick

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

GridItem

ग्रिड लेआउट में किसी आइटम को दिखाता है. आइटम में टेक्स्ट, इमेज या टेक्स्ट और इमेज, दोनों शामिल हो सकते हैं.

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

फ़ील्ड
id

string

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

image

ImageComponent

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

title

string

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

subtitle

string

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

layout

GridItemLayout

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

GridItemLayout

ग्रिड आइटम के लिए उपलब्ध अलग-अलग लेआउट विकल्प दिखाता है.

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

Enums
GRID_ITEM_LAYOUT_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
TEXT_BELOW टाइटल और सबटाइटल, ग्रिड आइटम की इमेज के नीचे दिखते हैं.
TEXT_ABOVE टाइटल और सबटाइटल, ग्रिड आइटम की इमेज के ऊपर दिखते हैं.

आइकॉन

कार्ड पर विजेट में दिखने वाला आइकॉन. Google Chat ऐप्लिकेशन में, आइकॉन जोड़ने का उदाहरण देखने के लिए, आइकॉन जोड़ना लेख पढ़ें.

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

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

फ़ील्ड
altText

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

ImageType

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

यूनियन फ़ील्ड icons. कार्ड पर विजेट में दिखने वाला आइकॉन. icons इनमें से कोई एक हो सकता है:
knownIcon

string

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

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

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

iconUrl

string

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

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

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

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

materialIcon

MaterialIcon

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

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

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

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

इमेज

ऐसी इमेज जिसे यूआरएल से दिखाया जाता है और जिसमें onClick ऐक्शन हो सकता है. उदाहरण के लिए, इमेज जोड़ना लेख देखें.

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

फ़ील्ड
imageUrl

string

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

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

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

OnClick

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

altText

string

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

ImageComponent

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

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

फ़ील्ड
imageUri

string

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

altText

string

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

cropStyle

ImageCropStyle

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

borderStyle

BorderStyle

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

ImageCropStyle

किसी इमेज पर लागू किए गए काटने के स्टाइल को दिखाता है.

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

उदाहरण के लिए, 16:9 आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) लागू करने का तरीका यहां बताया गया है:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
फ़ील्ड
type

ImageCropType

फ़ोटो का टाइप.

aspectRatio

double

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

उदाहरण के लिए, 16:9 आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) लागू करने का तरीका यहां बताया गया है:

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

ImageCropType

किसी इमेज पर लागू किए गए काटने के स्टाइल को दिखाता है.

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

Enums
IMAGE_CROP_TYPE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
SQUARE डिफ़ॉल्ट मान. स्क्वेयर फ़ॉर्मैट में काटता है.
CIRCLE सर्कुलर क्रॉप लागू करता है.
RECTANGLE_CUSTOM कस्टम आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) के साथ आयताकार काट-छांट करता है. aspectRatio की मदद से, आसपेक्ट रेशियो को पसंद के मुताबिक सेट करें.
RECTANGLE_4_3 4:3 के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) में, आयताकार काट-छांट करता है.

LinkPreview

कार्ड ऐक्शन, जो कार्ड और स्मार्ट चिप दिखाकर तीसरे पक्ष के लिंक की झलक दिखाता है. ज़्यादा जानने के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

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

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

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

उदाहरण में, लिंक की यह झलक दिखती है:

लिंक की झलक का उदाहरण

फ़ील्ड
previewCard

Card

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

title

string

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

linkPreviewTitle

string

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

MaterialIcon

Google Material आइकॉन, जिसमें 2500 से ज़्यादा विकल्प शामिल हैं.

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

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

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

फ़ील्ड
name

string

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

fill

bool

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

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

weight

int32

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

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

grade

int32

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

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

ModifyCard

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

फ़ील्ड

यूनियन फ़ील्ड operation.

operation इनमें से कोई एक हो सकता है:

updateWidget

UpdateWidget

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

UpdateWidget

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

फ़ील्ड
यूनियन फ़ील्ड updated_widget. विजेट में किए गए अपडेट. updated_widget इनमें से कोई एक हो सकता है:
selectionInputWidgetSuggestions

SelectionInputWidgetSuggestions

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

SelectionInputWidgetSuggestions

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

फ़ील्ड
suggestions[]

SelectionItem

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

कार्ड के स्टैक में, कार्ड को अपडेट करता है या कार्ड के बीच नेविगेट करता है.

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

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

1) नया कार्ड वापस करें (आगे बढ़ें).

 navigations : {
    pushCard : CARD
  }

2) स्टैक में सबसे ऊपर मौजूद कार्ड को अपडेट करें (जगह पर अपडेट).

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) अपडेट किए बिना एक चरण पीछे जाएं.

  navigations : {
    popCard : true,
  }

4) कई चरणों में पीछे जाएं और उस कार्ड को अपडेट करें.

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) किसी तय किए गए CARD_NAME पर वापस जाने के लिए, कई चरणों पर वापस जाएं.

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) रूट पर वापस जाएं और उस कार्ड को अपडेट करें.

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) चुने गए कार्ड पर जाएं और उसे भी पॉप-अप करें.

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) सबसे ऊपर मौजूद कार्ड को नए कार्ड से बदलें.

  navigations : {
    updateCard : CARD
  }
फ़ील्ड

यूनियन फ़ील्ड navigate_action.

navigate_action इनमें से कोई एक हो सकता है:

popToRoot

bool

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

pop

bool

एक कार्ड हट जाता है.

popToCard

string

यह सुविधा, दिए गए कार्ड के नाम के साथ, उस कार्ड के ऊपर मौजूद सभी कार्ड को पॉप अप करती है.

pushCard

Card

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

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

updateCard

Card

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

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

endNavigation

EndNavigation

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

सूचना

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

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

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

फ़ील्ड
text

string

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

OnClick

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

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

फ़ील्ड

यूनियन फ़ील्ड data.

data इनमें से कोई एक हो सकता है:

action

Action

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

openDynamicLinkAction

Action

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

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

card

Card

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

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

overflowMenu

OverflowMenu

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

OnClose

OnClick कार्रवाई से खोले गए लिंक को बंद करने पर, क्लाइंट क्या करता है.

लागू करने का तरीका, क्लाइंट प्लैटफ़ॉर्म की सुविधाओं पर निर्भर करता है. उदाहरण के लिए, हो सकता है कि कोई वेब ब्राउज़र, OnClose हैंडलर की मदद से पॉप-अप विंडो में कोई लिंक खोले.

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

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

Enums
NOTHING डिफ़ॉल्ट मान. कार्ड रीलोड नहीं होता और कुछ नहीं होता.
RELOAD

चाइल्ड विंडो बंद होने के बाद, कार्ड को फिर से लोड करता है.

OpenAs.OVERLAY के साथ इस्तेमाल करने पर, चाइल्ड विंडो एक मॉडल डायलॉग के तौर पर काम करती है. साथ ही, चाइल्ड विंडो के बंद होने तक पैरंट कार्ड ब्लॉक रहता है.

OpenAs

जब कोई OnClick कार्रवाई किसी लिंक को खोलती है, तो क्लाइंट उसे फ़ुल-साइज़ विंडो (अगर क्लाइंट ने फ़्रेम के तौर पर उसे इस्तेमाल किया है) या ओवरले (जैसे, पॉप-अप) के तौर पर खोल सकता है. लागू करने की सुविधा, क्लाइंट प्लैटफ़ॉर्म की क्षमताओं पर निर्भर करती है. अगर क्लाइंट इस सुविधा के साथ काम नहीं करता है, तो चुनी गई वैल्यू को अनदेखा किया जा सकता है. FULL_SIZE की सुविधा सभी क्लाइंट के साथ काम करती है.

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

Enums
FULL_SIZE अगर क्लाइंट ने फ़्रेम के तौर पर फ़ुल-साइज़ विंडो का इस्तेमाल किया है, तो लिंक फ़ुल-साइज़ विंडो के तौर पर खुलता है.
OVERLAY लिंक, ओवरले के तौर पर खुलता है. जैसे, पॉप-अप.

OverflowMenu

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

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

फ़ील्ड
items[]

OverflowMenuItem

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

OverflowMenuItem

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

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

फ़ील्ड
startIcon

Icon

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

text

string

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

onClick

OnClick

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

disabled

bool

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

RenderActions

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

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

फ़ील्ड
action

Action

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

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

hostAppAction

HostAppActionMarkup

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

schema

string

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

कार्रवाई

वे कार्रवाइयां जिनका इस्तेमाल ऐड-ऑन, कार्ड या होस्ट ऐप्लिकेशन में कर सकते हैं.

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

फ़ील्ड
navigations[]

Navigation

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

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

notification

Notification

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

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

linkPreview

LinkPreview

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

modifyOperations[]

ModifyCard

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

SelectionInput

ऐसा विजेट जो एक या उससे ज़्यादा यूज़र इंटरफ़ेस (यूआई) आइटम बनाता है. उपयोगकर्ता इन आइटम को चुन सकते हैं. सिर्फ़ dropdown और multiselect मेन्यू के लिए, फ़ॉर्म सबमिशन की पुष्टि करने की सुविधा काम करती है. जब Action.all_widgets_are_required को true पर सेट किया जाता है या Action.required_widgets में यह विजेट तय किया जाता है, तो कोई वैल्यू चुनने तक सबमिशन ऐक्शन ब्लॉक रहता है. उदाहरण के लिए, ड्रॉपडाउन मेन्यू या चेकबॉक्स. इस विजेट का इस्तेमाल करके, ऐसा डेटा इकट्ठा किया जा सकता है जिसका अनुमान लगाया जा सकता है या जिसकी गिनती की जा सकती है. Google Chat ऐप्लिकेशन में उदाहरण के लिए, चुने जा सकने वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना देखें.

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

उपयोगकर्ताओं से कोई खास या सामान्य डेटा इकट्ठा करने के लिए, TextInput विजेट का इस्तेमाल करें.

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

फ़ील्ड
name

string

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

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

label

string

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

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

type

SelectionType

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

items[]

SelectionItem

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

onChangeAction

Action

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

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

multiSelectMaxSelectedItems

int32

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

multiSelectMinQueryLength

int32

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

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

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

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

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

externalDataSource

Action

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

platformDataSource

PlatformDataSource

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

PlatformDataSource

SelectionInput विजेट के लिए, Google Workspace का डेटा सोर्स. यह विजेट, एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू का इस्तेमाल करता है. इसका इस्तेमाल, एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू में आइटम भरने के लिए किया जाता है.

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

फ़ील्ड
यूनियन फ़ील्ड data_source. डेटा सोर्स. data_source इनमें से कोई एक हो सकता है:
commonDataSource

CommonDataSource

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

hostAppDataSource

HostAppDataSourceMarkup

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

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

CommonDataSource

Google Workspace के सभी ऐप्लिकेशन के साथ शेयर किया जाने वाला डेटा सोर्स.

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

Enums
UNKNOWN डिफ़ॉल्ट मान. इस्तेमाल न करें.
USER Google Workspace के उपयोगकर्ता. उपयोगकर्ता सिर्फ़ अपने Google Workspace संगठन के उपयोगकर्ताओं को देख सकता है और उन्हें चुन सकता है.

SelectionItem

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

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

फ़ील्ड
text

string

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

value

string

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

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

selected

bool

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

startIconUri

string

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

bottomText

string

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

SelectionType

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

हर सिलेक्शन इनपुट में एक तरह का सिलेक्शन किया जा सकता है. उदाहरण के लिए, चेकबॉक्स और स्विच को एक साथ इस्तेमाल नहीं किया जा सकता.

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

Enums
CHECK_BOX चेकबॉक्स का एक सेट. उपयोगकर्ता एक या उससे ज़्यादा चेकबॉक्स चुन सकते हैं.
RADIO_BUTTON रेडियो बटन का एक सेट. उपयोगकर्ता एक रेडियो बटन चुन सकते हैं.
SWITCH स्विच का एक सेट. उपयोगकर्ता एक या उससे ज़्यादा स्विच चालू कर सकते हैं.
DROPDOWN ड्रॉपडाउन मेन्यू. उपयोगकर्ता, मेन्यू से एक आइटम चुन सकते हैं.
MULTI_SELECT

टेक्स्ट बॉक्स वाला मेन्यू. उपयोगकर्ता एक या उससे ज़्यादा आइटम टाइप और चुन सकते हैं. Google Workspace के ऐड-ऑन के लिए, आपको SelectionItem ऑब्जेक्ट के स्टैटिक कलेक्शन का इस्तेमाल करके आइटम भरने होंगे.

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

  • Google Workspace का डेटा: आइटम, Google Workspace के डेटा का इस्तेमाल करके पॉप्युलेट किए जाते हैं. जैसे, Google Workspace के उपयोगकर्ता या Google Chat के स्पेसेज़.
  • बाहरी डेटा: आइटम, Google Workspace से बाहर के किसी बाहरी डेटा सोर्स से पॉप्युलेट होते हैं.

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

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

SubmitFormResponse

फ़ॉर्म सबमिट करने पर मिलने वाला जवाब. इसमें, अपने-आप भरने वाले कंटेनर के अलावा, वे कार्रवाइयां शामिल होती हैं जो कार्ड और/या ऐड-ऑन होस्ट ऐप्लिकेशन को करनी चाहिए. साथ ही, यह भी बताया जाता है कि कार्ड की स्थिति में बदलाव हुआ है या नहीं.

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

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: salam.heba@example.com"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}
फ़ील्ड
renderActions

RenderActions

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

stateChanged

bool

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

schema

string

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

सुझाव

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

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

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

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

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

फ़ील्ड
items[]

SuggestionItem

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

SuggestionItem

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

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

फ़ील्ड

यूनियन फ़ील्ड content.

content इनमें से कोई एक हो सकता है:

text

string

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

TextInput

ऐसा फ़ील्ड जिसमें उपयोगकर्ता टेक्स्ट डाल सकते हैं. यह सुझावों और बदलाव होने पर की जाने वाली कार्रवाइयों के साथ काम करता है. फ़ॉर्म सबमिशन की पुष्टि करने की सुविधा के साथ काम करता है. जब Action.all_widgets_are_required को true पर सेट किया जाता है या इस विजेट को Action.required_widgets में बताया जाता है, तो वैल्यू डालने तक सबमिशन ऐक्शन ब्लॉक रहता है. Google Chat ऐप्लिकेशन में इसका उदाहरण देखने के लिए, ऐसा फ़ील्ड जोड़ना जिसमें उपयोगकर्ता टेक्स्ट डाल सके लेख पढ़ें.

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

जब आपको उपयोगकर्ताओं से कोई ऐसा डेटा इकट्ठा करना हो जो तय नहीं है या जो समझ में न आए, तो टेक्स्ट इनपुट का इस्तेमाल करें. उपयोगकर्ताओं से तय या गिनती वाला डेटा इकट्ठा करने के लिए, SelectionInput विजेट का इस्तेमाल करें.

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

फ़ील्ड
name

string

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

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

label

string

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

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

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

hintText

string

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

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

value

string

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

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

type

Type

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

onChangeAction

Action

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

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

initialSuggestions

Suggestions

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

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

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

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

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

autoCompleteAction

Action

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

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

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

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

validation

Validation

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

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

placeholderText

string

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

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

टाइप

यूज़र इंटरफ़ेस में टेक्स्ट इनपुट फ़ील्ड कैसा दिखता है. उदाहरण के लिए, यह एक लाइन वाला इनपुट फ़ील्ड है या कई लाइन वाला इनपुट. अगर initialSuggestions की वैल्यू दी गई है, तो type हमेशा SINGLE_LINE होता है. भले ही, इसे MULTIPLE_LINE पर सेट किया गया हो.

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

Enums
SINGLE_LINE टेक्स्ट इनपुट फ़ील्ड की ऊंचाई एक लाइन की होती है.
MULTIPLE_LINE टेक्स्ट इनपुट फ़ील्ड की ऊंचाई, कई लाइनों की होती है.

TextParagraph

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

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

फ़ील्ड
text

string

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

maxLines

int32

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

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

पुष्टि

यह उस विजेट की पुष्टि करने के लिए ज़रूरी डेटा दिखाता है जिससे यह जुड़ा है.

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

फ़ील्ड
characterLimit

int32

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

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

inputType

InputType

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

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

InputType

इनपुट विजेट का टाइप.

Enums
INPUT_TYPE_UNSPECIFIED टाइप की जानकारी नहीं दी गई है. इस्तेमाल न करें.
TEXT सामान्य टेक्स्ट, जिसमें सभी वर्ण इस्तेमाल किए जा सकते हैं.
INTEGER पूर्णांक वैल्यू.
FLOAT फ़्लोट वैल्यू.
EMAIL ईमेल पता.
EMOJI_PICKER सिस्टम में मौजूद इमोजी पिकर से चुना गया इमोजी.

विजेट

हर कार्ड में विजेट होते हैं.

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

फ़ील्ड
horizontalAlignment

HorizontalAlignment

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

यूनियन फ़ील्ड data. किसी विजेट में इनमें से सिर्फ़ एक आइटम हो सकता है. ज़्यादा आइटम दिखाने के लिए, एक से ज़्यादा विजेट फ़ील्ड का इस्तेमाल किया जा सकता है. data इनमें से कोई एक हो सकता है:
textParagraph

TextParagraph

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

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

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

Image

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

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

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

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

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

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

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

DateTimePicker

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

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

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

Divider

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

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

"divider": {
}
grid

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

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

Carousel

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

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

ChipList

चिप की सूची.

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

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

HorizontalAlignment

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

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

Enums
HORIZONTAL_ALIGNMENT_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
START डिफ़ॉल्ट मान. विजेट को कॉलम की शुरुआती पोज़िशन पर अलाइन करता है. बाएं से दाएं लेआउट के लिए, बाईं ओर अलाइन करता है. दाएं से बाएं लेआउट के लिए, दाईं ओर अलाइन करता है.
CENTER विजेट को कॉलम के बीच में अलाइन करता है.
END विजेट को कॉलम के आखिर में अलाइन करता है. बाएं से दाएं लेआउट के लिए, विजेट को दाईं ओर अलाइन करता है. दाएं से बाएं लेआउट के लिए, विजेट को बाईं ओर अलाइन करता है.

ImageType

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

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

Enums
SQUARE डिफ़ॉल्ट मान. इमेज पर स्क्वेयर मास्क लागू करता है. उदाहरण के लिए, 4x3 वाली इमेज 3x3 हो जाती है.
CIRCLE इमेज पर सर्कुलर मास्क लागू करता है. उदाहरण के लिए, 4x3 वाली इमेज, 3 डायमीटर वाला सर्कल बन जाती है.