Package google.apps.card.v1

इंडेक्स

कार्रवाई

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

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

फ़ील्ड
function

string

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

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

parameters[]

ActionParameter

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

loadIndicator

LoadIndicator

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

persistValues

bool

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

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

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

interaction

Interaction

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

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

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

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

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

requiredWidgets[]

string

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

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

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

allWidgetsAreRequired

bool

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

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

ActionParameter

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

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

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

फ़ील्ड
key

string

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

value

string

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

बातचीत

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

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

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

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

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

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

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

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

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

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

LoadIndicator

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

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

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

BorderStyle

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

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

फ़ील्ड
type

BorderType

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

strokeColor

Color

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

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

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

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

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

cornerRadius

int32

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

BorderType

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

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

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

बटन

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

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

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

फ़ील्ड
text

string

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

icon

Icon

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

color

Color

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

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

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

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

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

onClick

OnClick

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

disabled

bool

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

altText

string

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

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

type

Type

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

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

टाइप

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

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

Enums
TYPE_UNSPECIFIED इस्तेमाल न करें. नहीं बताया गया है
OUTLINED आउटलाइन वाले बटन, मध्यम आकार वाले बटन होते हैं. आम तौर पर, इनमें अहम कार्रवाइयां शामिल होती हैं. हालांकि, ये Chat ऐप्लिकेशन या ऐड-ऑन की मुख्य कार्रवाई नहीं होती.
FILLED भरे हुए बटन में एक कंटेनर होता है, जो एक ही रंग का होता है. यह सुविधा विज़ुअल पर सबसे ज़्यादा असर डालती है. इसे Chat ऐप्लिकेशन या ऐड-ऑन में ज़रूरी और मुख्य कार्रवाई के लिए इस्तेमाल करने का सुझाव दिया जाता है.
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 ऐप्लिकेशन में उदाहरण के लिए, कार्ड का सेक्शन तय करना देखें.

sectionDividerStyle

DividerStyle

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

cardActions[]

CardAction

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

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

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

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

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

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

fixedFooter

CardFixedFooter

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

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

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

displayStyle

DisplayStyle

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

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

peekCardHeader

CardHeader

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

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

CardAction

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

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

फ़ील्ड
actionLabel

string

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

onClick

OnClick

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

CardFixedFooter

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

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

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

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

फ़ील्ड
primaryButton

Button

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

secondaryButton

Button

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

CardHeader

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

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

फ़ील्ड
title

string

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

subtitle

string

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

imageType

ImageType

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

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

imageUrl

string

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

imageAltText

string

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

DisplayStyle

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

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

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

DividerStyle

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

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

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

सेक्शन

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

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

फ़ील्ड
header

string

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

widgets[]

Widget

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

collapsible

bool

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

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

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

uncollapsibleWidgetsCount

int32

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

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

collapseControl

CollapseControl

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

चिप

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

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

फ़ील्ड
icon

Icon

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

label

string

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

onClick

OnClick

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

enabled
(deprecated)

bool

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

disabled

bool

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

altText

string

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

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

ChipList

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

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

फ़ील्ड
layout

Layout

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

chips[]

Chip

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

लेआउट

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

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

CollapseControl

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

फ़ील्ड
horizontalAlignment

HorizontalAlignment

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

expandButton

Button

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

collapseButton

Button

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

कॉलम

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

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

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

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

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

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

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

Column

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

कॉलम

एक कॉलम.

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

फ़ील्ड
horizontalSizeStyle

HorizontalSizeStyle

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

horizontalAlignment

HorizontalAlignment

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

verticalAlignment

VerticalAlignment

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

widgets[]

Widgets

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

HorizontalSizeStyle

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

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

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

VerticalAlignment

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

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

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

विजेट

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

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

फ़ील्ड

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

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

textParagraph

TextParagraph

TextParagraph विजेट.

image

Image

Image विजेट.

decoratedText

DecoratedText

DecoratedText विजेट.

buttonList

ButtonList

ButtonList विजेट.

textInput

TextInput

TextInput विजेट.

selectionInput

SelectionInput

SelectionInput विजेट.

dateTimePicker

DateTimePicker

DateTimePicker विजेट.

chipList

ChipList

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

DateTimePicker

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

type

DateTimePickerType

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

valueMsEpoch

int64

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

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

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

int32

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

onChangeAction

Action

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

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 के पक्ष में, अब काम नहीं करता.

startIcon

Icon

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

topLabel

string

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

text

string

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

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

wrapText

bool

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

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

bottomLabel

string

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

onClick

OnClick

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

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

Button

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

switchControl

SwitchControl

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

endIcon

Icon

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

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

SwitchControl

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

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

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

फ़ील्ड
name

string

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

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

value

string

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

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

selected

bool

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

onChangeAction

Action

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

controlType

ControlType

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

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

ControlType

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

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

Enums
SWITCH टॉगल-स्टाइल वाला स्विच.
CHECKBOX CHECK_BOX के पक्ष में बहिष्कृत किया गया.
CHECK_BOX चेकबॉक्स.

डिवाइडर

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

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

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

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

"divider": {}

EndNavigation

डायलॉग फ़्लो कार्रवाई.

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

फ़ील्ड
action

Action

डायलॉग फ़्लो को खत्म करने के लिए, क्लाइंट के लिए रेंडर करने की कार्रवाई.

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

कार्रवाई

डायलॉग फ़्लो को खत्म करने के लिए, क्लाइंट के लिए रेंडर ऐक्शन टाइप.

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

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

GetAutocompletionResponse

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

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

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

Suggestions

schema

string

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

ग्रिड

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

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

string

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

items[]

GridItem

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

borderStyle

BorderStyle

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

columnCount

int32

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

onClick

OnClick

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

GridItem

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

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

फ़ील्ड
id

string

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

image

ImageComponent

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

title

string

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

subtitle

string

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

layout

GridItemLayout

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

GridItemLayout

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

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

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

आइकॉन

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

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

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

फ़ील्ड
altText

string

ज़रूरी नहीं. सुलभता के लिए इस्तेमाल किए जाने वाले आइकॉन के बारे में जानकारी. अगर इसके बारे में जानकारी नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू Button दी जाती है. सबसे सही तरीका यह है कि आपको इस बारे में जानकारी सेट करनी चाहिए कि आइकॉन क्या दिखाता है और अगर लागू हो, तो इससे क्या होता है. उदाहरण के लिए, A user's account portrait या Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

अगर आइकॉन को Button में सेट किया जाता है, तो उपयोगकर्ता के बटन पर कर्सर घुमाने पर altText, हेल्पर टेक्स्ट के तौर पर दिखता है. हालांकि, अगर यह बटन text को भी सेट करता है, तो आइकॉन के altText को अनदेखा कर दिया जाता है.

imageType

ImageType

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

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

string

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

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

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

iconUrl

string

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

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

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

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

materialIcon

MaterialIcon

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

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

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

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

इमेज

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

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

फ़ील्ड
imageUrl

string

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

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

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

OnClick

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

altText

string

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

ImageComponent

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

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

फ़ील्ड
imageUri

string

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

altText

string

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

cropStyle

ImageCropStyle

इमेज पर लागू करने के लिए काटने की शैली.

borderStyle

BorderStyle

इमेज पर लागू की जाने वाली बॉर्डर शैली.

ImageCropStyle

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

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

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

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

ImageCropType

क्रॉप टाइप.

aspectRatio

double

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

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

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

ImageCropType

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

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

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

LinkPreview

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

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

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

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

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

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

फ़ील्ड
previewCard

Card

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

title

string

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

linkPreviewTitle

string

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

MaterialIcon

एक Google मटीरियल आइकॉन, जिसमें 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 फ़ॉन्ट आइकॉन पर जाएं और पसंद के मुताबिक बनाएं में जाकर, सेटिंग में बदलाव करें.

कार्ड स्टैक में बदलाव करने वाली कार्ड कार्रवाई.

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

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

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

 navigations : {
    pushCard : CARD
  }

2) स्टैक (जगह का अपडेट) के ऊपर कार्ड अपडेट करें.

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

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

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

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

  navigations : {
    popCard : true,
  }

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

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

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

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

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

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

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

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

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

7) बताए गए कार्ड पर पॉप करें और उसे भी पॉप करें.

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

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

8) ऊपर वाले कार्ड को नए कार्ड से बदलें. चैट ऐप्लिकेशन के लिए, यह सिर्फ़ ऐप्लिकेशन के होम पेज पर उपलब्ध है.

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

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

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

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

popToRoot

bool

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

pop

bool

कार्ड स्टैक से एक कार्ड बाहर निकलता है.

popToCard

string

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

pushCard

Card

कार्ड स्टैक, कार्ड को कार्ड स्टैक पर भेजता है.

updateCard

Card

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

endNavigation

EndNavigation

Dialogflow की मदद से नेविगेशन ऐक्शन खत्म करना. ज़्यादा जानकारी के लिए, Google Chat ऐप्लिकेशन के लिए होम पेज बनाना लेख पढ़ें

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

सूचना

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

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

फ़ील्ड
text

string

सूचना में दिखाने के लिए सादा टेक्स्ट. इसमें एचटीएमएल टैग शामिल नहीं हैं.

OnClick

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

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

फ़ील्ड

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

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

action

Action

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

openDynamicLinkAction

Action

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

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

card

Card

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

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

overflowMenu

OverflowMenu

अगर तय किया गया है, तो यह onClick ओवरफ़्लो मेन्यू खोलता है. यह सुविधा, 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 के ऐड-ऑन के लिए उपलब्ध नहीं है.

फ़ील्ड
startIcon

Icon

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

text

string

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

onClick

OnClick

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

disabled

bool

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

RenderActions

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

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

फ़ील्ड
action

Action

hostAppAction

HostAppActionMarkup

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

schema

string

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

कार्रवाई

फ़ील्ड
navigations[]

Navigation

दिखाए गए कार्ड पुश, पॉप या अपडेट करें.

notification

Notification

असली उपयोगकर्ता को सूचना दिखाएं.

linkPreview

LinkPreview

असली उपयोगकर्ता को लिंक की झलक दिखाएं.

SelectionInput

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

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

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

type

SelectionType

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

items[]

SelectionItem

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

onChangeAction

Action

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

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

multiSelectMaxSelectedItems

int32

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

multiSelectMinQueryLength

int32

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

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

validation

Validation

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

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

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

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

externalDataSource

Action

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

platformDataSource

PlatformDataSource

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

PlatformDataSource

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

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

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

CommonDataSource

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

hostAppDataSource

HostAppDataSourceMarkup

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

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

CommonDataSource

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

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

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

SelectionItem

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

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

फ़ील्ड
text

string

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

value

string

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

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

selected

bool

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

startIconUri

string

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

bottomText

string

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

SelectionType

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

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

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

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

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

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

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

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

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

SubmitFormResponse

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

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

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

RenderActions

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

stateChanged

bool

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

schema

string

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

सुझाव

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

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

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

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

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

फ़ील्ड
items[]

SuggestionItem

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

SuggestionItem

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

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

फ़ील्ड

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

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

text

string

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

TextInput

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

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

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

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

hintText

string

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

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

value

string

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

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

type

Type

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

onChangeAction

Action

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

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

initialSuggestions

Suggestions

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

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

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

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

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

autoCompleteAction

Action

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

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

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

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

validation

Validation

इस टेक्स्ट इनपुट फ़ील्ड के लिए ज़रूरी पुष्टि तय करें.

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

placeholderText

string

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

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

टाइप

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

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

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

TextParagraph

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

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

फ़ील्ड
text

string

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

maxLines

int32

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

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

पुष्टि

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

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

फ़ील्ड
characterLimit

int32

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

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

inputType

InputType

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

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

InputType

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

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

विजेट

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

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

फ़ील्ड
horizontalAlignment

HorizontalAlignment

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

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

TextParagraph

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

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

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

Image

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

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

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

DecoratedText

सजाए गए टेक्स्ट आइटम को दिखाता है.

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

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

ButtonList

बटन की सूची.

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

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

TextInput

यह एक टेक्स्ट बॉक्स दिखाता है, जिसमें लोग टाइप कर सकते हैं.

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

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

एक अन्य उदाहरण के तौर पर, यह JSON फ़ॉर्मैट, स्टैटिक सुझावों की मदद से प्रोग्रामिंग भाषा के लिए टेक्स्ट इनपुट बनाता है:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

SelectionInput

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

उदाहरण के लिए, नीचे दिया गया JSON एक ड्रॉपडाउन मेन्यू बनाता है, जिससे उपयोगकर्ता साइज़ चुन सकते हैं:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

DateTimePicker

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

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

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

Divider

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

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

"divider": {
}
grid

Grid

आइटम के कलेक्शन वाला ग्रिड दिखाता है.

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

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 के व्यास वाले सर्कल में बदल जाती है.