Package google.apps.card.v1

string

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

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

ActionParameter

ऐक्शन पैरामीटर की सूची.

LoadIndicator

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

bool

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

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

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

Interaction

ज़रूरी नहीं. डायलॉग खोलने पर, यह एट्रिब्यूट ज़रूरी है.

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

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

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

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

string

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

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

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

bool

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

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

string

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

string

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

BorderType

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

Color

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

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

उदाहरण के लिए, यहां दिए गए कोड से रंग को सबसे ज़्यादा इंटेंसिटी पर लाल रंग पर सेट किया जाता है:

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

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

int32

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

string

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

Icon

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

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

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

bool

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

string

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

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

Type

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

Button

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

CardHeader

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

Section

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

DividerStyle

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

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

string

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

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

CardFixedFooter

इस कार्ड के सबसे नीचे फ़ुटर दिखाया गया है.

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

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

DisplayStyle

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

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

CardHeader

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

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

ExpressionData

कार्ड के लिए एक्सप्रेशन डेटा.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

string

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

OnClick

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

Button

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

Button

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

string

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

string

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

ImageType

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

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

string

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

string

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

TextParagraph

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

ButtonList

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

Image

इमेज विजेट.

string

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

Widget

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

bool

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

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

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

int32

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

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

string

यह सेक्शन को असाइन किया गया यूनीक आईडी होता है. इसका इस्तेमाल, सेक्शन की पहचान करने के लिए किया जाता है, ताकि उसमें बदलाव किया जा सके. आईडी में 64 वर्ण से ज़्यादा नहीं होने चाहिए. साथ ही, यह [a-zA-Z0-9-]+ फ़ॉर्मैट में होना चाहिए.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

CollapseControl

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

CarouselCard

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

NestedWidget

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

NestedWidget

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

Icon

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

string

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

OnClick

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

bool

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

bool

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

string

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

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

Layout

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

Chip

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

HorizontalAlignment

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

Button

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

Button

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

Column

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

HorizontalSizeStyle

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

HorizontalAlignment

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

VerticalAlignment

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

Widgets

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

TextParagraph

TextParagraph विजेट.

Image

Image विजेट.

DecoratedText

DecoratedText विजेट.

ButtonList

ButtonList विजेट.

TextInput

TextInput विजेट.

SelectionInput

SelectionInput विजेट.

DateTimePicker

DateTimePicker विजेट.

ChipList

ChipList विजेट.

string

ActionRule का यूनीक आइडेंटिफ़ायर.

ExpressionDataCondition

वह शर्त जो एक्सप्रेशन डेटा से तय होती है.

ConditionType

शर्त किस तरह की है.

HostAppDataActionMarkup

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

Action

यह डेटा, डेटा उपलब्ध कराने वाली किसी रिमोट कंपनी से मिला है.

PlatformDataSource

डेटा, Google Workspace ऐप्लिकेशन से लिया गया हो.

string

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

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

string

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

DateTimePickerType

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

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) का इस्तेमाल करें.

int32

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

Action

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

HostAppDataSourceMarkup

ऐसा डेटा सोर्स जो Google Workspace के होस्ट ऐप्लिकेशन के लिए यूनीक हो. जैसे, Gmail के ईमेल, Google Calendar के इवेंट या Google Chat के मैसेज.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

Icon

startIcon के लिए अब काम नहीं करता.

Icon

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

VerticalAlignment

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

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

string

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

TextParagraph

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

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

string

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

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

TextParagraph

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

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

bool

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

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

string

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

TextParagraph

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

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

OnClick

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

Button

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

SwitchControl

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

Icon

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

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

string

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

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

string

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

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

bool

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

Action

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

ControlType

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

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

Action

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

string

ActionRule का यूनीक आइडेंटिफ़ायर.

Trigger

उन ट्रिगर की सूची जिन्हें EventAction के पूरा होने के बाद ट्रिगर किया जाएगा.

CommonWidgetAction

विजेट की सामान्य कार्रवाई.

UpdateVisibilityAction

विजेट दिखे या न दिखे, यह सेट करने की कार्रवाई.

Visibility

किसको दिखे.

string

ExpressionData का यूनीक आइडेंटिफ़ायर.

string

बिना कंपाइल किया गया एक्सप्रेशन.

Condition

शर्तों की सूची, जो एक्सप्रेशन के आकलन के नतीजे से तय होती हैं.

EventAction

कार्रवाइयों की सूची, जिनके लिए ExpressionData का इस्तेमाल किया जा सकता है.

Suggestions

string

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

string

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

GridItem

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

BorderStyle

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

int32

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

OnClick

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

string

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

ImageComponent

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

string

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

string

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

GridItemLayout

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

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

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

string

Google Workspace की ओर से उपलब्ध कराए गए किसी एक बिल्ट-इन आइकॉन को दिखाएं.

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

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

string

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

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

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

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

MaterialIcon

Google Material Icons में से कोई एक आइकॉन दिखाएं.

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

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

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

string

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

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

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

OnClick

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

string

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

string

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

string

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

ImageCropStyle

इमेज पर काटने की स्टाइल लागू करें.

BorderStyle

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

ImageCropType

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

double

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

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

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

string

ऐड-ऑन पर वापस जाने के लिए लिंक का यूआरएल.

string

ऐड-ऑन पर वापस जाने के लिए लिंक का टाइटल.

Card

ऐसा कार्ड जिसमें तीसरे पक्ष की सेवा से मिले लिंक के बारे में जानकारी दिखती है.

string

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

string

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

string

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

bool

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

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

int32

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

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

int32

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

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

UpdateWidget

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

SelectionInputWidgetSuggestions

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

SelectionItem

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

bool

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

bool

इससे एक कार्ड हट जाता है.

string

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

Card

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

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

Card

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

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

EndNavigation

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

string

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

Action

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

OpenLink

अगर यह विकल्प चुना जाता है, तो onClick से लिंक खोलने की कार्रवाई ट्रिगर होती है.

Action

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

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

Card

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

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

OverflowMenu

अगर तय किया गया है, तो यह onClick ओवरफ़्लो मेन्यू खोलता है.

string

खोलने के लिए यूआरएल.

OpenAs

लिंक खोलने का तरीका.

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

OnClose

क्लाइंट लिंक खोलने के बाद उसे भूल जाता है या विंडो बंद होने तक उसे देखता रहता है.

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

OverflowMenuItem

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

Icon

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

string

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

OnClick

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

bool

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

Action

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

Google Chat में ऐड-ऑन.

HostAppActionMarkup

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

string

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

Navigation

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

Google Chat में ऐड-ऑन.

OpenLink

इससे टारगेट लिंक, नए टैब या पॉप-अप विंडो में खुलता है.

Notification

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

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

LinkPreview

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

Link

यह सुविधा Google Docs में उपलब्ध है. यह फ़ंक्शन, तीसरे पक्ष के संसाधन से लिंक दिखाता है और उसे होस्ट ऐप्लिकेशन में स्मार्ट चिप में बदलता है. इसे एक आइटम वाले ऑब्जेक्ट के कलेक्शन के तौर पर फ़ॉर्मैट किया जाता है.

ज़्यादा जानकारी के लिए, @ मेन्यू से तीसरे पक्ष के संसाधन बनाना लेख पढ़ें.

ModifyCard

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

string

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

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

string

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

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

SelectionType

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

SelectionItem

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

Action

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

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

int32

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

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

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

DataSourceConfig

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

अगर यह विकल्प चुना जाता है, तो multi_select_max_selected_items फ़ील्ड, multi_select_min_query_length फ़ील्ड, external_data_source फ़ील्ड, और platform_data_source फ़ील्ड को अनदेखा कर दिया जाता है.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

int32

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

string

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

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

Action

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

PlatformDataSource

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

CommonDataSource

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

HostAppDataSourceMarkup

ऐसा डेटा सोर्स जो Google Workspace के होस्ट ऐप्लिकेशन के लिए यूनीक हो. जैसे, Google Chat में स्पेसेज़.

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

string

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

string

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

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

bool

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

string

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

string

RenderActions

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

bool

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

string

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

SuggestionItem

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

string

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

string

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

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

string

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

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

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

string

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

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

string

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

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

Type

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

Action

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

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

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

Action

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

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

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

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

Validation

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

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

string

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

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

HostAppDataSourceMarkup

ऐसा डेटा सोर्स जो Google Workspace के होस्ट ऐप्लिकेशन के लिए यूनीक हो. जैसे, Gmail के ईमेल, Google Calendar के इवेंट या Google Chat के मैसेज.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

string

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

int32

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

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

TextSyntax

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

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

string

ActionRule का यूनीक आइडेंटिफ़ायर.

int32

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

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

InputType

इनपुट विजेट का टाइप तय करें.

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

HorizontalAlignment

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

string

यह विजेट को असाइन किया गया यूनीक आईडी होता है. इसका इस्तेमाल, बदले जाने वाले विजेट की पहचान करने के लिए किया जाता है. आईडी में 64 वर्ण से ज़्यादा नहीं होने चाहिए. साथ ही, यह [a-zA-Z0-9-]+ फ़ॉर्मैट में होना चाहिए.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

Visibility

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

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

EventAction

इससे यह तय होता है कि विजेट पर कौनसी इवेंट कार्रवाइयां की जा सकती हैं.

यह सुविधा, Google Workspace के उन ऐड-ऑन के लिए उपलब्ध है जो Google Workspace के फ़्लो को बढ़ाते हैं. यह Gemini Alpha program के तहत उपलब्ध है. यह Google Chat ऐप्लिकेशन के लिए उपलब्ध नहीं है.

TextParagraph

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

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

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

Image

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

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

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

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

बटन की सूची.

उदाहरण के लिए, यहां दिए गए 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

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

उदाहरण के लिए, यहां दिया गया 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

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

उदाहरण के लिए, यहां दिया गया 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

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

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

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

Divider

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

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

"divider": {
}

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

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

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

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

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

ChipList

चिप की सूची.

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

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