Package google.apps.card.v1

इंडेक्स

कार्रवाई

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

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

फ़ील्ड
function

string

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

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

parameters[]

ActionParameter

कार्रवाई पैरामीटर की सूची.

load_indicator

LoadIndicator

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

persist_values

bool

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

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

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

interaction

Interaction

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

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

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

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

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

required_widgets[]

string

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

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

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

all_widgets_are_required

bool

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

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

ActionParameter

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

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

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

फ़ील्ड
key

string

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

value

string

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

बातचीत

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

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

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

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

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

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

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

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

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

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

LoadIndicator

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

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

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

BorderStyle

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

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

फ़ील्ड
type

BorderType

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

stroke_color

Color

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

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

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

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

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

corner_radius

int32

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

BorderType

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

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

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

बटन

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

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

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

फ़ील्ड
text

string

बटन के अंदर प्रदर्शित होने वाला टेक्स्ट.

icon

Icon

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

color

Color

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

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

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

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

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

on_click

OnClick

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

disabled

bool

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

alt_text

string

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

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

type

Type

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

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

टाइप

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

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

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

ButtonList

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

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

फ़ील्ड
buttons[]

Button

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

कार्ड

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

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

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

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

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

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

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

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

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

CardHeader

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

sections[]

Section

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

section_divider_style

DividerStyle

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

card_actions[]

CardAction

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

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

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

"card_actions": [
  {
    "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 ऐप्लिकेशन के लिए उपलब्ध नहीं है.

display_style

DisplayStyle

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

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

peek_card_header

CardHeader

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

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

CardAction

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

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

फ़ील्ड
action_label

string

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

on_click

OnClick

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

CardFixedFooter

कार्ड के सबसे नीचे दिखने वाला एक स्थायी (स्टिकी) फ़ुटर.

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

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

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

फ़ील्ड
primary_button

Button

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

secondary_button

Button

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

CardHeader

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

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

फ़ील्ड
title

string

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

subtitle

string

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

image_type

ImageType

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

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

image_url

string

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

image_alt_text

string

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

DisplayStyle

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

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

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

DividerStyle

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

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

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

सेक्शन

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

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

फ़ील्ड
header

string

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

widgets[]

Widget

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

collapsible

bool

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

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

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

uncollapsible_widgets_count

int32

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

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

collapse_control

CollapseControl

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

चिप

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

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

फ़ील्ड
icon

Icon

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

label

string

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

on_click

OnClick

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

enabled
(deprecated)

bool

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

disabled

bool

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

alt_text

string

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

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

ChipList

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

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

फ़ील्ड
layout

Layout

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

chips[]

Chip

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

लेआउट

चिप लिस्ट लेआउट.

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

CollapseControl

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

फ़ील्ड
horizontal_alignment

HorizontalAlignment

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

expand_button

Button

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

collapse_button

Button

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

कॉलम

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

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

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

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

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

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

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

Column

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

कॉलम

कॉलम.

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

फ़ील्ड
horizontal_size_style

HorizontalSizeStyle

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

horizontal_alignment

HorizontalAlignment

इससे पता चलता है कि विजेट, कॉलम के बाईं ओर हैं, दाईं ओर या बीच में.

vertical_alignment

VerticalAlignment

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

widgets[]

Widgets

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

HorizontalSizeStyle

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

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

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

VerticalAlignment

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

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

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

विजेट

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

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

फ़ील्ड

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

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

text_paragraph

TextParagraph

TextParagraph विजेट.

image

Image

Image विजेट.

decorated_text

DecoratedText

DecoratedText विजेट.

button_list

ButtonList

ButtonList विजेट.

text_input

TextInput

TextInput विजेट.

selection_input

SelectionInput

SelectionInput विजेट.

date_time_picker

DateTimePicker

DateTimePicker विजेट.

chip_list

ChipList

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

DateTimePicker

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

type

DateTimePickerType

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

value_ms_epoch

int64

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

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

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

int32

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

on_change_action

Action

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

validation

Validation

ज़रूरी नहीं. इस तारीख और समय चुनने वाले टूल के लिए, पुष्टि करने का तरीका बताएं.

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

DateTimePickerType

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

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

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

DecoratedText

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

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

फ़ील्ड
icon
(deprecated)

Icon

startIcon के पक्ष में बहिष्कृत किया गया.

start_icon

Icon

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

top_label

string

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

text

string

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

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

wrap_text

bool

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

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

bottom_label

string

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

on_click

OnClick

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

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

Button

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

switch_control

SwitchControl

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

end_icon

Icon

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

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

SwitchControl

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

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

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

फ़ील्ड
name

string

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

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

value

string

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

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

selected

bool

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

on_change_action

Action

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

control_type

ControlType

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

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

ControlType

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

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

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

डिवाइडर

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

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

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

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

"divider": {}

ग्रिड

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

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

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

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

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

string

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

items[]

GridItem

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

border_style

BorderStyle

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

column_count

int32

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

on_click

OnClick

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

GridItem

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

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

फ़ील्ड
id

string

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

image

ImageComponent

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

title

string

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

subtitle

string

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

layout

GridItemLayout

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

GridItemLayout

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

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

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

आइकॉन

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

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

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

फ़ील्ड
alt_text

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 को अनदेखा कर दिया जाता है.

image_type

ImageType

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

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

string

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

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

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

icon_url

string

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

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

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

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

material_icon

MaterialIcon

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

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

"material_icon": {
  "name": "check_box"
}

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

इमेज

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

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

फ़ील्ड
image_url

string

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

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

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

OnClick

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

alt_text

string

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

ImageComponent

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

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

फ़ील्ड
image_uri

string

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

alt_text

string

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

crop_style

ImageCropStyle

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

border_style

BorderStyle

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

ImageCropStyle

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

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

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

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

ImageCropType

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

aspect_ratio

double

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

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

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

ImageCropType

यह इमेज काटने की स्टाइल दिखाता है.

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

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

MaterialIcon

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

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

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

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

फ़ील्ड
name

string

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

fill

bool

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

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

weight

int32

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

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

grade

int32

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

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

OnClick

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

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

फ़ील्ड

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

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

action

Action

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

card

Card

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

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

overflow_menu

OverflowMenu

अगर तय किया गया है, तो यह onClick ओवरफ़्लो मेन्यू खोलता है. यह सुविधा, Google Chat ऐप्लिकेशन के लिए उपलब्ध है. हालांकि, यह Google Workspace के ऐड-ऑन के लिए उपलब्ध नहीं है.

OnClose

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

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

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

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

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

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

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

OpenAs

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

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

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

OverflowMenu

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

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

फ़ील्ड
items[]

OverflowMenuItem

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

OverflowMenuItem

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

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

फ़ील्ड
start_icon

Icon

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

text

string

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

on_click

OnClick

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

disabled

bool

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

SelectionInput

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

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

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

type

SelectionType

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

items[]

SelectionItem

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

on_change_action

Action

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

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

multi_select_max_selected_items

int32

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

multi_select_min_query_length

int32

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

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

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

Validation

ड्रॉपडाउन मेन्यू के लिए, इस चुनिंदा इनपुट फ़ील्ड की पुष्टि.

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

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

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

external_data_source

Action

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

platform_data_source

PlatformDataSource

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

PlatformDataSource

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

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

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

CommonDataSource

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

host_app_data_source

HostAppDataSourceMarkup

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

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

CommonDataSource

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

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

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

SelectionItem

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

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

फ़ील्ड
text

string

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

value

string

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

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

selected

bool

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

start_icon_uri

string

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

bottom_text

string

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

SelectionType

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

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

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

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

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

Google Workspace के ऐड-ऑन के लिए, आपको SelectionItem ऑब्जेक्ट के स्टैटिक कलेक्शन का इस्तेमाल करके आइटम भरने होंगे.

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

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

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

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

सुझाव

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

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

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

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

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

फ़ील्ड
items[]

SuggestionItem

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

SuggestionItem

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

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

फ़ील्ड

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

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

text

string

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

TextInput

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

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

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

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

hint_text

string

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

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

value

string

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

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

type

Type

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

on_change_action

Action

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

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

initial_suggestions

Suggestions

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

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

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

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

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

auto_complete_action

Action

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

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

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

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

validation

Validation

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

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

placeholder_text

string

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

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

टाइप

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

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

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

TextParagraph

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

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

फ़ील्ड
text

string

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

max_lines

int32

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

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

पुष्टि

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

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

फ़ील्ड
character_limit

int32

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

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

input_type

InputType

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

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

InputType

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

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

विजेट

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

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

फ़ील्ड
horizontal_alignment

HorizontalAlignment

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

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

TextParagraph

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

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

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

Image

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

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

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

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"
  }
}
button_list

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

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

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
    }
  ]
}
date_time_picker

DateTimePicker

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

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

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

Divider

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

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

"divider": {
}
grid

Grid

आइटम के संग्रह के साथ ग्रिड दिखाता है.

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

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

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

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

Columns

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

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

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

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

ChipList

चिप की सूची.

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

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

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

HorizontalAlignment

इससे पता चलता है कि विजेट, कॉलम के बाईं ओर हैं, दाईं ओर या बीच में.

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

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

ImageType

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

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

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