Cards v1

कार्ड

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

JSON के काेड में दिखाना
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
फ़ील्ड
header

object (CardHeader)

कार्ड का हेडर. हेडर में आम तौर पर एक टाइटल और एक इमेज होती है.

sections[]

object (Section)

सेक्शन को लाइन डिवाइडर से अलग किया जाता है.

cardActions[]

object (CardAction)

इस कार्ड पर की जाने वाली कार्रवाइयां.

name

string

कार्ड का नाम.

CardHeader

JSON के काेड में दिखाना
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
फ़ील्ड
title

string

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

subtitle

string

कार्ड के हेडर का सबटाइटल.

imageStyle

enum (ImageStyle)

इमेज का टाइप (उदाहरण के लिए, स्क्वेयर बॉर्डर या गोल बॉर्डर).

imageUrl

string

कार्ड के हेडर में मौजूद इमेज का यूआरएल.

ImageStyle

Enums
IMAGE_STYLE_UNSPECIFIED
IMAGE स्क्वेयर बॉर्डर.
AVATAR गोलाकार बॉर्डर.

सेक्शन

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

JSON के काेड में दिखाना
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
फ़ील्ड
header

string

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

widgets[]

object (WidgetMarkup)

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

WidgetMarkup

विजेट एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट है, जिसमें टेक्स्ट और इमेज होती हैं.

JSON के काेड में दिखाना
{
  "buttons": [
    {
      object (Button)
    }
  ],

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
फ़ील्ड
buttons[]

object (Button)

बटन की सूची. बटन भी oneof data है और इनमें से सिर्फ़ एक फ़ील्ड सेट किया जाना चाहिए.

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

object (TextParagraph)

इस विजेट में टेक्स्ट पैराग्राफ़ दिखाएं.

image

object (Image)

इस विजेट में कोई इमेज दिखाएं.

keyValue

object (KeyValue)

इस विजेट में मुख्य वैल्यू वाला आइटम दिखाएं.

TextParagraph

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

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

string

इमेज

ऐसी इमेज जिसे यूआरएल से दिखाया गया हो और जिस पर onclick ऐक्शन किया जा सकता हो.

JSON के काेड में दिखाना
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
फ़ील्ड
imageUrl

string

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

onClick

object (OnClick)

onclick कार्रवाई.

aspectRatio

number

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

OnClick

कोई onclick ऐक्शन (उदाहरण के लिए, कोई लिंक खोलना).

JSON के काेड में दिखाना
{

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

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

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

action

object (FormAction)

अगर onclick ऐक्शन तय किया गया है, तो फ़ॉर्म ऐक्शन ट्रिगर होता है.

FormAction

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

JSON के काेड में दिखाना
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
फ़ील्ड
actionMethodName

string

तरीके के नाम का इस्तेमाल यह पता लगाने के लिए किया जाता है कि फ़ॉर्म के किस हिस्से से फ़ॉर्म सबमिशन ट्रिगर हुआ. यह जानकारी, कार्ड पर क्लिक करने के इवेंट के हिस्से के तौर पर, Chat ऐप्लिकेशन में वापस भेजी जाती है. एक ही तरह का व्यवहार ट्रिगर करने वाले कई एलिमेंट के लिए, एक ही तरीके के नाम का इस्तेमाल किया जा सकता है.

parameters[]

object (ActionParameter)

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

ActionParameter

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

JSON के काेड में दिखाना
{
  "key": string,
  "value": string
}
फ़ील्ड
key

string

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

value

string

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

KeyValue

यूज़र इंटरफ़ेस (यूआई) एलिमेंट में, एक कुंजी (लेबल) और वैल्यू (कॉन्टेंट) होती है. इस एलिमेंट में, onclick बटन जैसी कुछ कार्रवाइयां भी शामिल हो सकती हैं.

JSON के काेड में दिखाना
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
फ़ील्ड
topLabel

string

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

content

string

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

contentMultiline

boolean

कॉन्टेंट मल्टीलाइन होना चाहिए या नहीं.

bottomLabel

string

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

onClick

object (OnClick)

onclick कार्रवाई. सिर्फ़ टॉप लेबल, बॉटम लेबल, और कॉन्टेंट क्षेत्र पर क्लिक किया जा सकता है.

यूनियन फ़ील्ड icons. आइकॉन, top_label और bottom_label में से कम से कम एक की जानकारी देना ज़रूरी है. icons इनमें से सिर्फ़ एक हो सकता है:
icon

enum (Icon)

एक ऐसी वैल्यू जिसे Chat API, उससे जुड़ी आइकॉन इमेज से बदल देता है.

iconUrl

string

यूआरएल से तय किया गया आइकॉन.

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

object (Button)

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

आइकॉन

काम करने वाले आइकॉन का सेट.

Enums
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

बटन

बटन. यह टेक्स्ट बटन या इमेज बटन हो सकता है.

JSON के काेड में दिखाना
{

  // Union field type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
फ़ील्ड

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

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

textButton

object (TextButton)

टेक्स्ट और onclick ऐक्शन वाला बटन.

imageButton

object (ImageButton)

इमेज और onclick ऐक्शन वाला बटन.

TextButton

टेक्स्ट और onclick कार्रवाई वाला बटन.

JSON के काेड में दिखाना
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
फ़ील्ड
text

string

बटन का टेक्स्ट.

onClick

object (OnClick)

बटन की onclick कार्रवाई.

ImageButton

onclick ऐक्शन वाला इमेज बटन.

JSON के काेड में दिखाना
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
फ़ील्ड
onClick

object (OnClick)

onclick ऐक्शन.

name

string

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

यूनियन फ़ील्ड icons. आइकॉन के तौर पर, Icon enum या यूआरएल का इस्तेमाल किया जा सकता है. icons इनमें से सिर्फ़ एक हो सकता है:
icon

enum (Icon)

enum के ज़रिए तय किया गया आइकॉन, जो Chat API से मिले आइकॉन को इंडेक्स करता है.

iconUrl

string

यूआरएल से तय किया गया आइकॉन.

CardAction

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

Google Chat ऐप्लिकेशन पर काम नहीं करता.

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

string

यह लेबल, ऐक्शन मेन्यू आइटम में दिखाया जाता था.

onClick

object (OnClick)

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