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)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
}
फ़ील्ड
buttons[]

object (Button)

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

WidgetMarkup में इनमें से सिर्फ़ एक आइटम हो सकता है. ज़्यादा आइटम दिखाने के लिए, एक से ज़्यादा WidgetMarkup फ़ील्ड इस्तेमाल किए जा सकते हैं. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 के काेड में दिखाना 
{

  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
}
फ़ील्ड
यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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)
  },

  "icon": enum (Icon),
  "iconUrl": string

  "button": {
    object (Button)
  }
}
फ़ील्ड
topLabel

string

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

content

string

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

contentMultiline

boolean

अगर कॉन्टेंट को कई लाइनों में दिखाना है.

bottomLabel

string

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

onClick

object (OnClick)

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

आइकॉन, top_label, और bottom_label में से कम से कम एक को तय करना ज़रूरी है. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
icon

enum (Icon)

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

iconUrl

string

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

एक-दूसरे से अलग फ़ील्ड का अंत.
कंट्रोल विजेट. button या switch_widget में से किसी एक को सेट किया जा सकता है, लेकिन दोनों को नहीं. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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

बटन

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

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

  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
}
फ़ील्ड
यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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,

  "icon": enum (Icon),
  "iconUrl": string
}
फ़ील्ड
onClick

object (OnClick)

onclick कार्रवाई.

name

string

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

आइकॉन को Icon enum या यूआरएल से तय किया जा सकता है. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
icon

enum (Icon)

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

iconUrl

string

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

एक-दूसरे से अलग फ़ील्ड का अंत.

CardAction

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

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

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

string

ऐक्शन मेन्यू आइटम में दिखने वाला लेबल.

onClick

object (OnClick)

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