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 कार्रवाई.