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

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

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

type

Type

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

टाइप

ज़रूरी नहीं. बटन का टाइप. अगर 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 ऐड-ऑन में दिखने वाला कार्ड इंटरफ़ेस.

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

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

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

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

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

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

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

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

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

NestedWidget

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

फ़ील्ड

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

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

textParagraph

TextParagraph

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

buttonList

ButtonList

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

image

Image

इमेज विजेट.

सेक्शन

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

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

फ़ील्ड
header

string

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

widgets[]

Widget

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

collapsible

bool

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

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

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

uncollapsibleWidgetsCount

int32

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

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

collapseControl

CollapseControl

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

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

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

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Third text paragraph in carousel",
          }
        }
      ]
    }
  ]
}

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

फ़ील्ड
carouselCards[]

CarouselCard

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

CarouselCard

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

फ़ील्ड
widgets[]

NestedWidget

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

footerWidgets[]

NestedWidget

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

चिप

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

यह सुविधा, 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

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

collapseButton

Button

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

कॉलम

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

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

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

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

दो से ज़्यादा कॉलम शामिल करने या पंक्तियों का इस्तेमाल करने के लिए, 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 ऐड-ऑन और Chat ऐप्लिकेशन

फ़ील्ड

यूनियन फ़ील्ड 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 विजेट.

DataActions

ऐड-ऑन की कार्रवाई, जो Google Workspace के डेटा को अपडेट करती है.

फ़ील्ड
hostAppDataAction

HostAppDataActionMarkup

इससे यह तय होता है कि Google Workspace के डेटा को कैसे अपडेट किया जाए.

DateTimePicker

इसकी मदद से उपयोगकर्ता, तारीख, समय या दोनों डाल सकते हैं. फ़ॉर्म सबमिट करने की पुष्टि करने की सुविधा उपलब्ध है. जब Action.all_widgets_are_required को true पर सेट किया जाता है या इस विजेट को Action.required_widgets में तय किया जाता है, तो वैल्यू चुने जाने तक सबमिट करने की कार्रवाई को ब्लॉक कर दिया जाता है. 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 इंटरफ़ेस में मौजूद सेव करें या मिटाएं पर क्लिक करता है.

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

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

startIconVerticalAlignment

VerticalAlignment

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

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

topLabel

string

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

topLabelText

TextParagraph

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

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

text

string

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

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

contentText

TextParagraph

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

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

wrapText

bool

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

यह सुविधा सिर्फ़ text पर काम करती है, topLabel और bottomLabel पर नहीं.

bottomLabel

string

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

bottomLabelText

TextParagraph

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

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

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 में ऐड-ऑन के लिए, यह डायलॉग को बंद करता है.

फ़ील्ड
action

Action

Google Chat में ऐड-ऑन के लिए, यह कार्रवाई डायलॉग को बंद करती है.

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

कार्रवाई

Google Chat में ऐड-ऑन के लिए, डायलॉग बंद करने की कार्रवाइयां.

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

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

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

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

string

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

items[]

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 Material Icons में से कोई एक आइकॉन दिखाएं.

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

"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

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

linkPreviewTitle

string

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

MaterialIcon

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

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

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

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

फ़ील्ड
name

string

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

fill

bool

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

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

weight

int32

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

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

grade

int32

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

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

ModifyCard

Google Chat में ऐड-ऑन के लिए, यह फ़ंक्शन उपयोगकर्ता के इंटरैक्शन के आधार पर कार्ड को अपडेट करता है. ऐरे में सिर्फ़ एक ऑब्जेक्ट होना चाहिए.

फ़ील्ड

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

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

updateWidget

UpdateWidget

Google Chat में ऐड-ऑन के लिए, यह कार्ड या डायलॉग बॉक्स में विजेट को अपडेट करता है.

UpdateWidget

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

फ़ील्ड
यूनियन फ़ील्ड updated_widget. विजेट से जुड़े अपडेट. updated_widget इनमें से सिर्फ़ एक हो सकता है:
selectionInputWidgetSuggestions

SelectionInputWidgetSuggestions

selectionInput विजेट के लिए, मल्टीसिलेक्ट मेन्यू में सुझाए गए आइटम का कलेक्शन. जब कोई मल्टीसिलेक्ट मेन्यू, आइटम की सूची बनाने के लिए किसी बाहरी डेटा सोर्स का इस्तेमाल करता है, तो विजेट, मेन्यू में टाइप किए गए टेक्स्ट के आधार पर सुझावों को डाइनैमिक तरीके से भर सकता है. ज़्यादा जानकारी के लिए, Google Chat के उपयोगकर्ताओं से जानकारी इकट्ठा करना लेख पढ़ें.

SelectionInputWidgetSuggestions

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

फ़ील्ड
suggestions[]

SelectionItem

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

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

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

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

1) नया कार्ड दिखाएं (आगे बढ़ें).

 navigations : {
    pushCard : CARD
  }

2) स्टैक में सबसे ऊपर मौजूद कार्ड को अपडेट करें (जगह पर अपडेट करें).

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

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

  navigations : {
    popCard : true,
  }

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

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

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

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

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

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

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

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

8) सबसे ऊपर मौजूद कार्ड की जगह नया कार्ड लगाएं.

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

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

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

popToRoot

bool

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

pop

bool

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

popToCard

string

इस फ़ंक्शन से, दिए गए कार्ड के नाम वाले कार्ड के ऊपर मौजूद सभी कार्ड दिखते हैं.

pushCard

Card

इस तरीके का इस्तेमाल करके, कार्ड को कार्ड स्टैक में जोड़ा जाता है.

Google Chat में मौजूद डायलॉग बॉक्स के लिए, यह डायलॉग बॉक्स को खोलता है या अपडेट करता है.

updateCard

Card

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

Google Chat में मौजूद डायलॉग बॉक्स के लिए, यह डायलॉग बॉक्स को खोलता है या अपडेट करता है.

endNavigation

EndNavigation

Google Chat में ऐड-ऑन के लिए, यह डायलॉग को बंद करता है.

सूचना

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

Google Chat में ऐड-ऑन के लिए, जब उपयोगकर्ता कोई डायलॉग सबमिट करके बंद करते हैं, तब यह सूचना दिखाता है.

यह सुविधा, 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 ओवरफ़्लो मेन्यू खोलता है.

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

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

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

फ़ील्ड
action

Action

ऐड-ऑन, यूज़र इंटरफ़ेस (यूआई) को अपडेट करने के लिए इस कार्रवाई का इस्तेमाल कर सकते हैं.

Google Chat में ऐड-ऑन.

hostAppAction

HostAppActionMarkup

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

schema

string

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

कार्रवाई

कार्रवाइयां, जिन्हें ऐड-ऑन, कार्ड या होस्ट ऐप्लिकेशन में इस्तेमाल कर सकते हैं.

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

फ़ील्ड
navigations[]

Navigation

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

Google Chat में ऐड-ऑन.

notification

Notification

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

Google Chat में ऐड-ऑन के लिए, जब उपयोगकर्ता कोई डायलॉग सबमिट करके बंद करते हैं, तब यह सूचना दिखाता है.

linkPreview

LinkPreview

यह सुविधा Google Docs, Google Sheets, और Google Slides में उपलब्ध है. स्मार्ट चिप और कार्ड की मदद से लिंक की झलक दिखाता है. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

modifyOperations[]

ModifyCard

Google Chat में ऐड-ऑन के लिए, यह फ़ंक्शन उपयोगकर्ता के इंटरैक्शन के आधार पर कार्ड को अपडेट करता है. ऐरे में सिर्फ़ एक ऑब्जेक्ट होना चाहिए.

SelectionInput

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

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

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

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

फ़ील्ड
name

string

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

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

label

string

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

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

type

SelectionType

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

items[]

SelectionItem

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

onChangeAction

Action

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

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

multiSelectMaxSelectedItems

int32

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

multiSelectMinQueryLength

int32

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

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

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

string

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

यह सुविधा सिर्फ़ Google Workspace Workflows के साथ काम करती है. हालांकि, यह Google Chat API या 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 क्लाइंट लाइब्रेरी के साथ काम करता है. हालांकि, यह Cloud Client Libraries में उपलब्ध नहीं है. ज़्यादा जानने के लिए, क्लाइंट लाइब्रेरी इंस्टॉल करना लेख पढ़ें.

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

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

bottomText

string

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

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

string

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

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 पर सेट किया गया है, तो यह हमेशा SINGLE_LINE पर ही रहेगा. भले ही, इसे MULTIPLE_LINE पर सेट किया गया हो.

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

फ़ील्ड
items[]

SuggestionItem

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

SuggestionItem

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

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

फ़ील्ड

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

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

text

string

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

TextInput

ऐसा फ़ील्ड जिसमें उपयोगकर्ता टेक्स्ट डाल सकते हैं. यह सुझावों और बदलाव होने पर की जाने वाली कार्रवाइयों के साथ काम करता है. फ़ॉर्म सबमिट करने की पुष्टि करने की सुविधा उपलब्ध है. जब Action.all_widgets_are_required को true पर सेट किया जाता है या इस विजेट को Action.required_widgets में तय किया जाता है, तो वैल्यू डाले जाने तक सबमिट करने की कार्रवाई ब्लॉक हो जाती है. 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 पर सेट किया गया है, तो यह हमेशा 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 होती है. इस मामले में, पूरा कॉन्टेक्स्ट दिखता है. नेगेटिव वैल्यू को अनदेखा कर दिया जाता है.

textSyntax

TextSyntax

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

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

TextSyntax

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

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

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

पुष्टि

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

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

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

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

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

Columns

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

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

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

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

Carousel

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

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

ChipList

चिप की सूची.

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

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

HorizontalAlignment

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

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

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

ImageType

इमेज को काटने के लिए इस्तेमाल किया गया शेप.

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

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

VerticalAlignment

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

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