Cards v2

कार्ड

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"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
JSON के काेड में दिखाना
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "sectionDividerStyle": enum (DividerStyle),
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  }
}
फ़ील्ड
header

object (CardHeader)

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

sections[]

object (Section)

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

sectionDividerStyle

enum (DividerStyle)

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

cardActions[]

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

displayStyle

enum (DisplayStyle)

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

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

peekCardHeader

object (CardHeader)

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

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

CardHeader

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

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

JSON के काेड में दिखाना
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
फ़ील्ड
title

string

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

subtitle

string

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

imageType

enum (ImageType)

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

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

imageUrl

string

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

imageAltText

string

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

ImageType

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

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

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

सेक्शन

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

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

JSON के काेड में दिखाना
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "collapseControl": {
    object (CollapseControl)
  }
}
फ़ील्ड
header

string

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

widgets[]

object (Widget)

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

collapsible

boolean

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

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

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

uncollapsibleWidgetsCount

integer

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

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

collapseControl

object (CollapseControl)

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

विजेट

हर कार्ड, विजेट से बना होता है.

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

JSON के काेड में दिखाना
{
  "horizontalAlignment": enum (HorizontalAlignment),

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड
horizontalAlignment

enum (HorizontalAlignment)

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

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

object (TextParagraph)

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

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

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

object (Image)

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

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

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

object (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

object (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

object (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

object (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

object (DateTimePicker)

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

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

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

object (Divider)

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

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

"divider": {
}
grid

object (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

object (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

object (Carousel)

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

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

object (ChipList)

चिप की सूची.

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

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

TextParagraph

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

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

JSON के काेड में दिखाना
{
  "text": string,
  "maxLines": integer
}
फ़ील्ड
text

string

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

maxLines

integer

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

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

इमेज

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

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

JSON के काेड में दिखाना
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}
फ़ील्ड
imageUrl

string

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

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

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

object (OnClick)

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

altText

string

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

OnClick

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

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

JSON के काेड में दिखाना
{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  },
  "overflowMenu": {
    object (OverflowMenu)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड

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

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

action

object (Action)

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

card

object (Card)

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

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

overflowMenu

object (OverflowMenu)

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

कार्रवाई

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

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

JSON के काेड में दिखाना
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction),
  "requiredWidgets": [
    string
  ],
  "allWidgetsAreRequired": boolean
}
फ़ील्ड
function

string

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

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

parameters[]

object (ActionParameter)

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

loadIndicator

enum (LoadIndicator)

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

persistValues

boolean

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

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

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

interaction

enum (Interaction)

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

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

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

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

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

requiredWidgets[]

string

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

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

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

allWidgetsAreRequired

boolean

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

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

ActionParameter

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

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

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

JSON के काेड में दिखाना
{
  "key": string,
  "value": string
}
फ़ील्ड
key

string

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

value

string

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

LoadIndicator

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

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

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

बातचीत

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

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

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

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

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

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

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

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

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

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

OpenAs

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

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

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

OnClose

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

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

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

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

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

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

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

OverflowMenu

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

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

JSON के काेड में दिखाना
{
  "items": [
    {
      object (OverflowMenuItem)
    }
  ]
}
फ़ील्ड
items[]

object (OverflowMenuItem)

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

OverflowMenuItem

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

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

JSON के काेड में दिखाना
{
  "startIcon": {
    object (Icon)
  },
  "text": string,
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean
}
फ़ील्ड
startIcon

object (Icon)

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

text

string

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

onClick

object (OnClick)

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

disabled

boolean

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

आइकॉन

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

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

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

JSON के काेड में दिखाना
{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
  // End of list of possible types for union field icons.
}
फ़ील्ड
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

enum (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

object (MaterialIcon)

Google के Material आइकॉन में से कोई एक आइकॉन दिखाएं.

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

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

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

MaterialIcon

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

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

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

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

JSON के काेड में दिखाना
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
फ़ील्ड
name

string

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

fill

boolean

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

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

weight

integer

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

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

grade

integer

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

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

DecoratedText

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

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

JSON के काेड में दिखाना
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "topLabel": string,
  "text": string,
  "wrapText": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
  // End of list of possible types for union field control.
}
फ़ील्ड
icon
(deprecated)

object (Icon)

इसे अब इस्तेमाल नहीं किया जाता. इसके बजाय, startIcon का इस्तेमाल करें.

startIcon

object (Icon)

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

topLabel

string

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

text

string

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

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

wrapText

boolean

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

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

bottomLabel

string

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

onClick

object (OnClick)

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

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

object (Button)

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

switchControl

object (SwitchControl)

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

endIcon

object (Icon)

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

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

बटन

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

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

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

JSON के काेड में दिखाना
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
फ़ील्ड
text

string

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

icon

object (Icon)

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

color

object (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

object (OnClick)

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

disabled

boolean

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

altText

string

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

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

type

enum (Type)

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

रंग

RGBA कलर स्पेस में किसी रंग को दिखाता है. इस डेटा को इस तरह से डिज़ाइन किया गया है कि इसे अलग-अलग भाषाओं में आसानी से रंग के तौर पर दिखाया जा सके. उदाहरण के लिए, इस रिप्रज़ेंटेशन के फ़ील्ड को Java में java.awt.Color के कॉन्स्ट्रक्टर को आसानी से दिया जा सकता है. साथ ही, इसे iOS में UIColor के +colorWithRed:green:blue:alpha तरीके को भी आसानी से दिया जा सकता है. इसके अलावा, थोड़े से काम से इसे JavaScript में सीएसएस rgba() स्ट्रिंग में आसानी से फ़ॉर्मैट किया जा सकता है.

इस रेफ़रंस पेज पर, उस कलर स्पेस के बारे में जानकारी नहीं है जिसका इस्तेमाल आरजीबी वैल्यू को समझने के लिए किया जाना चाहिए. उदाहरण के लिए, sRGB, Adobe RGB, DCI-P3, और BT.2020. डिफ़ॉल्ट रूप से, ऐप्लिकेशन को sRGB कलर स्पेस का इस्तेमाल करना चाहिए.

जब यह तय करना हो कि दो रंग एक जैसे हैं या नहीं, तो लागू करने के दौरान, दो रंगों को एक जैसे माना जाता है. ऐसा तब किया जाता है, जब उनके लाल, हरे, नीले, और अल्फा रंग की वैल्यू में ज़्यादा से ज़्यादा 1e-5 का अंतर हो. हालांकि, अगर इसके लिए कोई अन्य दस्तावेज़ उपलब्ध है, तो ऐसा नहीं किया जाता.

उदाहरण (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

उदाहरण (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

उदाहरण (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON के काेड में दिखाना
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
फ़ील्ड
red

number

रंग में लाल रंग की मात्रा, [0, 1] इंटरवल में वैल्यू के तौर पर.

green

number

रंग में हरे रंग की मात्रा, जो [0, 1] की रेंज में होती है.

blue

number

रंग में नीले रंग की मात्रा, [0, 1] इंटरवल में वैल्यू के तौर पर.

alpha

number

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

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

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

टाइप

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

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

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

SwitchControl

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

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

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

JSON के काेड में दिखाना
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
फ़ील्ड
name

string

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

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

value

string

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

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

selected

boolean

जब true, स्विच चुना जाता है.

onChangeAction

object (Action)

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

controlType

enum (ControlType)

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

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

ControlType

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

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

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

ButtonList

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

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

JSON के काेड में दिखाना
{
  "buttons": [
    {
      object (Button)
    }
  ]
}
फ़ील्ड
buttons[]

object (Button)

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

TextInput

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

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

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

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

JSON के काेड में दिखाना
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "validation": {
    object (Validation)
  },
  "placeholderText": string
}
फ़ील्ड
name

string

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

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

label

string

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

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

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

hintText

string

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

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

value

string

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

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

type

enum (Type)

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

onChangeAction

object (Action)

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

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

initialSuggestions

object (Suggestions)

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

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

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

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

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

autoCompleteAction

object (Action)

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

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

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

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

validation

object (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 टेक्स्ट इनपुट फ़ील्ड की ऊंचाई तय होती है और इसमें एक से ज़्यादा लाइनें होती हैं.

RenderActions

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

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

फ़ील्ड
action

Action

कार्रवाई

फ़ील्ड
navigations[]

Navigation

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

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

स्टैक में नया कार्ड जोड़ें (आगे बढ़ें). Chat ऐप्लिकेशन के लिए, यह सुविधा सिर्फ़ ऐप्लिकेशन के होम पेज पर उपलब्ध है.

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

navigations: {
  pushCard: CARD
}

सबसे ऊपर मौजूद कार्ड को नए कार्ड से बदलें. Chat ऐप्लिकेशन के लिए, यह सुविधा सिर्फ़ ऐप्लिकेशन के होम पेज पर उपलब्ध है.

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

navigations: {
  updateCard: CARD
}

सुझाव

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

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

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

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

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

JSON के काेड में दिखाना
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
फ़ील्ड
items[]

object (SuggestionItem)

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

SuggestionItem

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

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

JSON के काेड में दिखाना
{

  // Union field content can be only one of the following:
  "text": string
  // End of list of possible types for union field content.
}
फ़ील्ड

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

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

text

string

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

पुष्टि

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

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

JSON के काेड में दिखाना
{
  "characterLimit": integer,
  "inputType": enum (InputType)
}
फ़ील्ड
characterLimit

integer

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

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

inputType

enum (InputType)

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

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

InputType

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

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

SelectionInput

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

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

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

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

JSON के काेड में दिखाना
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  },
  "multiSelectMaxSelectedItems": integer,
  "multiSelectMinQueryLength": integer,

  // Union field multi_select_data_source can be only one of the following:
  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  // End of list of possible types for union field multi_select_data_source.
}
फ़ील्ड
name

string

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

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

label

string

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

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

type

enum (SelectionType)

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

items[]

object (SelectionItem)

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

onChangeAction

object (Action)

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

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

multiSelectMaxSelectedItems

integer

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

multiSelectMinQueryLength

integer

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

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

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

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

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

externalDataSource

object (Action)

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

platformDataSource

object (PlatformDataSource)

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

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

SelectionItem

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

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

JSON के काेड में दिखाना
{
  "text": string,
  "value": string,
  "selected": boolean,
  "startIconUri": string,
  "bottomText": string
}
फ़ील्ड
text

string

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

value

string

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

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

selected

boolean

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

startIconUri

string

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

bottomText

string

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

PlatformDataSource

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

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

JSON के काेड में दिखाना
{

  // Union field data_source can be only one of the following:
  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
  // End of list of possible types for union field data_source.
}
फ़ील्ड
यूनियन फ़ील्ड data_source. डेटा सोर्स. data_source इनमें से कोई एक हो सकता है:
commonDataSource

enum (CommonDataSource)

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

hostAppDataSource

object (HostAppDataSourceMarkup)

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

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

CommonDataSource

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

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

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

HostAppDataSourceMarkup

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

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

JSON के काेड में दिखाना
{

  // Union field data_source can be only one of the following:
  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  }
  // End of list of possible types for union field data_source.
}
फ़ील्ड
यूनियन फ़ील्ड data_source. Google Workspace का वह ऐप्लिकेशन जो एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए आइटम भरता है. data_source इनमें से कोई एक हो सकता है:
chatDataSource

object (ChatClientDataSourceMarkup)

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

ChatClientDataSourceMarkup

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

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

JSON के काेड में दिखाना
{

  // Union field source can be only one of the following:
  "spaceDataSource": {
    object (SpaceDataSource)
  }
  // End of list of possible types for union field source.
}
फ़ील्ड
यूनियन फ़ील्ड source. Google Chat का डेटा सोर्स. source इनमें से कोई एक हो सकता है:
spaceDataSource

object (SpaceDataSource)

Google Chat के वे स्पेस जिनका उपयोगकर्ता सदस्य है.

SpaceDataSource

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

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

JSON के काेड में दिखाना
{
  "defaultToCurrentSpace": boolean
}
फ़ील्ड
defaultToCurrentSpace

boolean

अगर इसे true पर सेट किया जाता है, तो मल्टी-सिलेक्ट मेन्यू, डिफ़ॉल्ट रूप से Google Chat के मौजूदा स्पेस को आइटम के तौर पर चुनता है.

DateTimePicker

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

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

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

JSON के काेड में दिखाना
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
फ़ील्ड
name

string

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

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

label

string

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

type

enum (DateTimePickerType)

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

valueMsEpoch

string (int64 format)

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

पिकर के टाइप ( 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

integer

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

onChangeAction

object (Action)

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

DateTimePickerType

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

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

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

डिवाइडर

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

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

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

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

"divider": {}

ग्रिड

आइटम के कलेक्शन वाला ग्रिड दिखाता है. आइटम में सिर्फ़ टेक्स्ट या इमेज शामिल की जा सकती हैं. रिस्पॉन्सिव कॉलम के लिए या टेक्स्ट या इमेज के अलावा और भी चीज़ें शामिल करने के लिए, 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"
    }
  }
}
JSON के काेड में दिखाना
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
फ़ील्ड
title

string

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

items[]

object (GridItem)

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

borderStyle

object (BorderStyle)

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

columnCount

integer

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

onClick

object (OnClick)

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

GridItem

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

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

JSON के काेड में दिखाना
{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}
फ़ील्ड
id

string

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

image

object (ImageComponent)

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

title

string

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

subtitle

string

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

layout

enum (GridItemLayout)

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

ImageComponent

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

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

JSON के काेड में दिखाना
{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}
फ़ील्ड
imageUri

string

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

altText

string

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

cropStyle

object (ImageCropStyle)

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

borderStyle

object (BorderStyle)

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

ImageCropStyle

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

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

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

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
JSON के काेड में दिखाना
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
फ़ील्ड
type

enum (ImageCropType)

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

aspectRatio

number

अगर क्रॉप टाइप 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 आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) में रेक्टैंगल क्रॉप लागू करता है.

BorderStyle

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

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

JSON के काेड में दिखाना
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
फ़ील्ड
type

enum (BorderType)

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

strokeColor

object (Color)

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

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

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

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

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

cornerRadius

integer

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

BorderType

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

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

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

GridItemLayout

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

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

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

कॉलम

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

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

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

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

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

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

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

object (Column)

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

कॉलम

कॉलम.

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

JSON के काेड में दिखाना
{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}
फ़ील्ड
horizontalSizeStyle

enum (HorizontalSizeStyle)

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

horizontalAlignment

enum (HorizontalAlignment)

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

verticalAlignment

enum (VerticalAlignment)

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

widgets[]

object (Widgets)

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

HorizontalSizeStyle

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

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

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

HorizontalAlignment

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

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

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

VerticalAlignment

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

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

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

विजेट

ऐसे विजेट जिन्हें कॉलम में शामिल किया जा सकता है.

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

JSON के काेड में दिखाना
{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "chipList": {
    object (ChipList)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड

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

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

textParagraph

object (TextParagraph)

TextParagraph विजेट.

image

object (Image)

Image विजेट.

decoratedText

object (DecoratedText)

DecoratedText विजेट.

buttonList

object (ButtonList)

ButtonList विजेट.

textInput

object (TextInput)

TextInput विजेट.

selectionInput

object (SelectionInput)

SelectionInput विजेट.

dateTimePicker

object (DateTimePicker)

DateTimePicker विजेट.

chipList

object (ChipList)

ChipList विजेट.

ChipList

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

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

JSON के काेड में दिखाना
{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}
फ़ील्ड
layout

enum (Layout)

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

chips[]

object (Chip)

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

लेआउट

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

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

चिप

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

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

JSON के काेड में दिखाना
{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}
फ़ील्ड
icon

object (Icon)

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

label

string

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

onClick

object (OnClick)

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

enabled
(deprecated)

boolean

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

disabled

boolean

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

altText

string

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

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

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

उदाहरण के लिए, यह कैरसेल का 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 के ऐड-ऑन के लिए उपलब्ध नहीं है.

JSON के काेड में दिखाना
{
  "carouselCards": [
    {
      object (CarouselCard)
    }
  ]
}
फ़ील्ड
carouselCards[]

object (CarouselCard)

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

CarouselCard

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

JSON के काेड में दिखाना
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
फ़ील्ड
widgets[]

object (NestedWidget)

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

footerWidgets[]

object (NestedWidget)

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

NestedWidget

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

JSON के काेड में दिखाना
{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "buttonList": {
    object (ButtonList)
  },
  "image": {
    object (Image)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड

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

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

textParagraph

object (TextParagraph)

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

buttonList

object (ButtonList)

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

image

object (Image)

इमेज विजेट.

CollapseControl

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

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

JSON के काेड में दिखाना
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}
फ़ील्ड
horizontalAlignment

enum (HorizontalAlignment)

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

expandButton

object (Button)

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

collapseButton

object (Button)

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

DividerStyle

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

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

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

CardAction

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

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

JSON के काेड में दिखाना
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
फ़ील्ड
actionLabel

string

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

onClick

object (OnClick)

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

CardFixedFooter

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

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

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

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

JSON के काेड में दिखाना
{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}
फ़ील्ड
primaryButton

object (Button)

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

secondaryButton

object (Button)

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

DisplayStyle

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

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

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