Cards v2

कार्ड

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

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

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

कार्ड बिल्डर खोलें

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

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

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

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

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
जेएसओएन के काेड में दिखाना
{
  "header": {
    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 ऐड-ऑन के लिए उपलब्ध है.

जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध है.

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

string

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

widgets[]

object (Widget)

सेक्शन के सभी विजेट. कम से कम एक विजेट होना चाहिए.

collapsible

boolean

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

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

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

uncollapsibleWidgetsCount

integer

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

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

विजेट

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

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

जेएसओएन के काेड में दिखाना
{
  "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)
  }
  // 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,
        "alpha": 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"
          }
        }
      ]
    }
  ]
}

TextParagraph

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

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

जेएसओएन के काेड में दिखाना
{
  "text": string
}
फ़ील्ड
text

string

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

Image

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

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

जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध है.

जेएसओएन के काेड में दिखाना
{

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

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

data इनमें से सिर्फ़ एक हो सकती है:

action

object (Action)

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

card

object (Card)

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

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

ऐक्शन

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

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

जेएसओएन के काेड में दिखाना
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
फ़ील्ड
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 ऐड-ऑन के लिए उपलब्ध नहीं है.

ActionParameter

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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 ऐप्लिकेशन पर काम करती है. इसका इस्तेमाल, कार्ड मैसेज पर किए जाने वाले बटन-क्लिक की मदद से किया जा सकता है. अगर किसी ऐड-ऑन के लिए तय किया गया है, तो पूरा कार्ड हटा दिया जाता है और क्लाइंट में कुछ भी नहीं दिखता.

यह सुविधा 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 के साथ किया जाता है, तो चाइल्ड विंडो, मॉडल डायलॉग की तरह काम करती है. साथ ही, चाइल्ड विंडो के बंद होने तक पैरंट कार्ड ब्लॉक रहता है.

DecoratedText

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

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

जेएसओएन के काेड में दिखाना
{
  "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 ऐप्लिकेशन के बारे में जानने के लिए, आइकॉन जोड़ें को देखें.

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

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

जेएसओएन के काेड में दिखाना
{
  "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 के किसी एक मटीरियल आइकॉन को दिखाएं.

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

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

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

MaterialIcon

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

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

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

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

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

string

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

fill

boolean

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

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

weight

integer

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

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

grade

integer

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

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

बटन

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

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

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

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

string

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

icon

object (Icon)

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

color

object (Color)

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

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

लाल, हरे, और नीले रंग के लिए, हर फ़ील्ड की वैल्यू एक float नंबर है. इसे इन दोनों में से किसी भी तरीके से दिखाया जा सकता है: 0 से 255 के बीच की संख्या को 255 (153/255) से भाग देने पर या 0 और 1 (0.6) के बीच की वैल्यू के रूप में. 0 रंग का न होना दिखाता है और 1 या 255/255 आरजीबी स्केल पर उस रंग की पूरी मौजूदगी को दिखाता है.

विकल्प के तौर पर, alpha को सेट करें, जो इस समीकरण का इस्तेमाल करके, पारदर्शिता का लेवल सेट करता है:

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

alpha के लिए, 1 की वैल्यू एक ठोस रंग से मेल खाती है और 0 की वैल्यू पूरी तरह से पारदर्शी रंग से मेल खाती है.

उदाहरण के लिए, नीचे दिया गया रंग आधा पारदर्शी लाल दिखाता है:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
   "alpha": 0.5
}
onClick

object (OnClick)

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

disabled

boolean

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

altText

string

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

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

रंग

यह आरजीए कलर स्पेस में किसी रंग को दिखाता है. इस प्रज़ेंटेशन को इस तरह से डिज़ाइन किया गया है कि कई भाषाओं में इसे छोटा करके दिखाने में, आसानी से कन्वर्ज़न किया जा सके. उदाहरण के लिए, इस प्रज़ेंटेशन के फ़ील्ड को Java में java.awt.Color के कंस्ट्रक्टर को आसानी से दिया जा सकता है. iOS में, यूज़र इंटरफ़ेस (यूआई) के +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('');
};

// ...
जेएसओएन के काेड में दिखाना
{
  "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 वैल्यू दी गई हो.

SwitchControl

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध है.

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

object (Button)

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

TextInput

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "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 ऐप्लिकेशन के लिए उपलब्ध नहीं है.

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 Workspace ऐड-ऑन के लिए उपलब्ध है और Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

navigations: {
  pushCard: CARD
}

सबसे ऊपर वाले कार्ड की जगह नए कार्ड का इस्तेमाल करें.

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

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

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

object (SuggestionItem)

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

SuggestionItem

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

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

जेएसओएन के काेड में दिखाना
{

  // 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

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

SelectionInput

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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

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

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

यूनियन फ़ील्ड 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 Chat स्पेस का नाम टाइप करना शुरू कर सकते हैं और विजेट अपने-आप स्पेस का सुझाव देता है.

कई आइटम चुनने वाले मेन्यू के लिए आइटम भरने के लिए, इनमें से किसी एक तरह के डेटा सोर्स का इस्तेमाल किया जा सकता है:

  • स्टैटिक डेटा: आइटम को विजेट में SelectionItem ऑब्जेक्ट के तौर पर दिखाया जाता है. ज़्यादा से ज़्यादा 100 आइटम.
  • Google Workspace डेटा: Google Workspace के डेटा का इस्तेमाल करके, आइटम की जानकारी अपने-आप भर जाती है. जैसे, Google Workspace के उपयोगकर्ता या Google Chat स्पेस.
  • बाहरी डेटा: आइटम की जानकारी Google Workspace के बाहर के किसी बाहरी डेटा सोर्स से अपने-आप भर जाती है.

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

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

SelectionItem

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

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

जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध नहीं है.

जेएसओएन के काेड में दिखाना
{

  // 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 में मौजूद स्पेस.

CommonDataSource

एक डेटा सोर्स, जिसे Google Workspace के सभी ऐप्लिकेशन के साथ शेयर किया जाता है.

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

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

HostAppDataSourceMarkup

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

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

जेएसओएन के काेड में दिखाना
{

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

जेएसओएन के काेड में दिखाना
{

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

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

boolean

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

DateTimePicker

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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)

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

पिकर के टाइप ( 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"
    }
  }
}
जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध है.

जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध है.

जेएसओएन के काेड में दिखाना
{
  "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
}
जेएसओएन के काेड में दिखाना
{
  "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 ऐड-ऑन के लिए उपलब्ध है.

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

enum (BorderType)

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

strokeColor

object (Color)

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

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 dp से कम या उसके बराबर होने पर, दूसरे कॉलम में रैप हो जाता है.

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

Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है. Google Workspace ऐड-ऑन के कॉलम, 'डेवलपर के लिए झलक' में मौजूद हैं.

जेएसओएन के काेड में दिखाना
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
फ़ील्ड
columnItems[]

object (Column)

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

कॉलम

एक कॉलम.

Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है. Google Workspace ऐड-ऑन के कॉलम, 'डेवलपर के लिए झलक' में मौजूद हैं.

जेएसओएन के काेड में दिखाना
{
  "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 Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है. Google Workspace ऐड-ऑन के कॉलम, 'डेवलपर के लिए झलक' में मौजूद हैं.

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 Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है. Google Workspace ऐड-ऑन के कॉलम, 'डेवलपर के लिए झलक' में मौजूद हैं.

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

विजेट

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

Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है. Google Workspace ऐड-ऑन के कॉलम, 'डेवलपर के लिए झलक' में मौजूद हैं.

जेएसओएन के काेड में दिखाना
{

  // 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)
  }
  // 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 विजेट.

DividerStyle

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

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

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

CardAction

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

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

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

string

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

onClick

object (OnClick)

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

CardFixedFooter

एक स्थायी (स्टिकी) फ़ुटर, जो कार्ड के निचले हिस्से में दिखता है.

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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 डिफ़ॉल्ट मान. कार्ड स्टैक में सबसे ऊपर दिखने वाले कार्ड के व्यू की जगह, कार्ड दिखता है.