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 आइटम और 2 कॉलम वाले ग्रिड में 5 लाइनें होती हैं. 11 आइटम और 2 कॉलम वाली ग्रिड में 6 लाइनें होती हैं.

यह सुविधा, 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,
  "textSyntax": enum (TextSyntax)
}
फ़ील्ड
text

string

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

maxLines

integer

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

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

textSyntax

enum (TextSyntax)

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

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

TextSyntax

टेक्स्ट को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला सिंटैक्स.

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

Enums
TEXT_SYNTAX_UNSPECIFIED अगर इसे तय नहीं किया जाता है, तो टेक्स्ट को एचटीएमएल के तौर पर रेंडर किया जाता है.
HTML टेक्स्ट को एचटीएमएल के तौर पर रेंडर किया जाता है. यह डिफ़ॉल्ट मान है.
MARKDOWN टेक्स्ट को मार्कडाउन के तौर पर रेंडर किया जाता है.

इमेज

ऐसी इमेज जिसे यूआरएल से तय किया जाता है और जिसमें 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 पर सेट करें. Chat ऐप्लिकेशन में कार्ड मैसेज के लिए, आपको कार्रवाई का 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 Icons में से कोई एक आइकॉन दिखाएं.

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

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

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

MaterialIcon

A Google मटीरियल आइकॉन, जिसमें 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 Icon में तय किया गया आइकॉन का नाम होता है. उदाहरण के लिए, check_box. अमान्य नामों को हटा दिया जाता है और उनकी जगह खाली स्ट्रिंग डाल दी जाती है. इससे आइकॉन रेंडर नहीं हो पाता.

fill

boolean

क्या आइकॉन भरा हुआ दिखता है. डिफ़ॉल्ट वैल्यू false है.

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

weight

integer

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

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

grade

integer

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

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

DecoratedText

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

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

JSON के काेड में दिखाना
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "startIconVerticalAlignment": enum (VerticalAlignment),
  "topLabel": string,
  "topLabelText": {
    object (TextParagraph)
  },
  "text": string,
  "contentText": {
    object (TextParagraph)
  },
  "wrapText": boolean,
  "bottomLabel": string,
  "bottomLabelText": {
    object (TextParagraph)
  },
  "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)

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

startIconVerticalAlignment

enum (VerticalAlignment)

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

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

topLabel

string

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

topLabelText

object (TextParagraph)

TextParagraph topLabel के बराबर. हमेशा छोटा किया जाता है. इसमें topLabel की तुलना में ज़्यादा मुश्किल फ़ॉर्मैटिंग की जा सकती है.

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

text

string

ज़रूरी है. प्राइमरी टेक्स्ट.

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

contentText

object (TextParagraph)

TextParagraph text के बराबर. इसमें text की तुलना में ज़्यादा मुश्किल फ़ॉर्मैटिंग की जा सकती है.

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

wrapText

boolean

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

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

bottomLabel

string

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

bottomLabelText

object (TextParagraph)

TextParagraph bottomLabel के बराबर. हमेशा रैप होता है. इसमें bottomLabel की तुलना में ज़्यादा मुश्किल फ़ॉर्मैटिंग की जा सकती है.

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

onClick

object (OnClick)

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

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

object (Button)

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

switchControl

object (SwitchControl)

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

endIcon

object (Icon)

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

इसमें बिल्ट-इन और कस्टम आइकॉन इस्तेमाल किए जा सकते हैं.

VerticalAlignment

यह वर्टिकल अलाइनमेंट एट्रिब्यूट को दिखाता है.

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED टाइप की जानकारी नहीं दी गई है. इस्तेमाल न करें.
TOP टॉप पोज़िशन के साथ अलाइनमेंट.
MIDDLE बीच वाली पोज़िशन के साथ अलाइनमेंट.
BOTTOM बॉटम अलाइनमेंट.

बटन

यह एक टेक्स्ट, आइकॉन या टेक्स्ट और आइकॉन वाला बटन होता है. इस पर क्लिक किया जा सकता है. 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

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

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

type

enum (Type)

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

रंग

यह RGBA कलर स्पेस में किसी रंग को दिखाता है. इस फ़ॉर्मैट को इस तरह से डिज़ाइन किया गया है कि इसे अलग-अलग भाषाओं में रंग के फ़ॉर्मैट में आसानी से बदला जा सके. साथ ही, इसे रंग के फ़ॉर्मैट से वापस इसी फ़ॉर्मैट में बदला जा सके. उदाहरण के लिए, इस प्रज़ेंटेशन के फ़ील्ड को Java में java.awt.Color के कंस्ट्रक्टर को आसानी से दिया जा सकता है. साथ ही, इसे iOS में UIColor के +colorWithRed:green:blue:alpha तरीके को भी आसानी से दिया जा सकता है. इसके अलावा, इसे JavaScript में CSS 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 फ़िल्ड बटन में, एक कंटेनर होता है. इसका रंग एक जैसा होता है. इससे विज़ुअल पर सबसे ज़्यादा असर पड़ता है. साथ ही, इसे Chat ऐप्लिकेशन या ऐड-ऑन में सबसे ज़रूरी और प्राइमरी कार्रवाई के लिए इस्तेमाल करने का सुझाव दिया जाता है.
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)
  },
  "multiSelectMinQueryLength": integer,
  "multiSelectMaxSelectedItems": 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)

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

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

multiSelectMinQueryLength

integer

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

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

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

integer

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

यूनियन फ़ील्ड 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,
  "bottomText": string,

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

string

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

value

string

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

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

selected

boolean

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

bottomText

string

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

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

string

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 Client Libraries में उपलब्ध नहीं है. ज़्यादा जानने के लिए, क्लाइंट लाइब्रेरी इंस्टॉल करना लेख पढ़ें.

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 आइटम और 2 कॉलम वाले ग्रिड में 5 लाइनें होती हैं. 11 आइटम और 2 कॉलम वाली ग्रिड में 6 लाइनें होती हैं.

यह सुविधा, 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 pt से कम या इसके बराबर है, तो दूसरा कॉलम रैप हो जाता है.
  • 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 डिफ़ॉल्ट मान. कार्ड स्टैक में सबसे ऊपर मौजूद कार्ड की जगह पर, यह कार्ड दिखाया जाता है.