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)

यह एक इनम वैल्यू है, जिसे 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

बटन

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

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