Cards v1

कार्ड

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

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

object (CardHeader)

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

sections[]

object (Section)

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

cardActions[]

object (CardAction)

इस कार्ड से की गई कार्रवाइयां.

name

string

कार्ड का नाम.

CardHeader

जेएसओएन के काेड में दिखाना 
{
  "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 गोल बॉर्डर.

सेक्शन

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

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

string

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

widgets[]

object (WidgetMarkup)

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

WidgetMarkup

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

जेएसओएन के काेड में दिखाना 
{
  "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 ऐड-ऑन में टेक्स्ट फ़ॉर्मैट करना देखें.

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

string

Image

वह इमेज जिसे यूआरएल से तय किया गया हो और जिसमें onclick कार्रवाई हो सकती हो.

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

string

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

onClick

object (OnClick)

onclick कार्रवाई.

aspectRatio

number

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

OnClick

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

जेएसओएन के काेड में दिखाना 
{

  // 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 को शुरू किया जा सकता है.

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

string

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

parameters[]

object (ActionParameter)

कार्रवाई पैरामीटर की सूची.

ActionParameter

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

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

string

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

value

string

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

KeyValue

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

जेएसओएन के काेड में दिखाना 
{
  "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)

Enum वैल्यू को 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

बटन

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

जेएसओएन के काेड में दिखाना 
{

  // 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 कार्रवाई वाला बटन.

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

string

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

onClick

object (OnClick)

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

ImageButton

onclick कार्रवाई वाला इमेज बटन.

जेएसओएन के काेड में दिखाना 
{
  "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 ऐप्लिकेशन के साथ काम नहीं करती.

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

string

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

onClick

object (OnClick)

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