इस पेज पर, टेक्स्ट और कार्ड मैसेज के बीच अंतर बताया गया है.
जब Chat ऐप्लिकेशन बुनियादी जानकारी देने के लिए मैसेज भेजते हैं, मैसेज इनलाइन दिखते हैं, ठीक वैसे ही जैसे Google Chat में लोग लिखते हैं मैसेज. ज़्यादा टेक्स्ट वाले मैसेज बनाने के लिए या मैसेज, जिनके साथ उपयोगकर्ता इंटरैक्ट कर सकते हैं और Chat ऐप्लिकेशन इस्तेमाल कर सकते हैं कार्ड. चैट ऐप्लिकेशन, कार्ड के साथ मैसेज भी जोड़ सकते हैं. यहां की यात्रा पर हूं उपयोगकर्ताओं को कई चरणों वाली प्रोसेस को पूरा करने के लिए कहना. जैसे, फ़ॉर्म भरना, चैट ऐप्लिकेशन भी नई विंडो में खुलने वाले कार्ड इस तरह बना सकते हैं: डायलॉग सबमिट किए.
टेक्स्ट मैसेज का स्ट्रक्चर
Google Chat API में, मैसेज को JSON ऑब्जेक्ट के तौर पर दिखाया जाता है. किसी मैसेज में,
मैसेज को इस तरह दिखाया जाता है:
text
ऑब्जेक्ट है.
निम्न में उदाहरण के लिए, कोई Chat ऐप्लिकेशन किसी स्पेस में मैसेज बनाता है सॉफ़्टवेयर डेवलपर की टीम को मिला है, जो कोड फ़्रीज़ होने वाली है:
{
"text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}
JSON से यह मैसेज मिलता है:
कार्ड मैसेज की बनावट
Google Chat API में, मैसेज को JSON ऑब्जेक्ट के तौर पर दिखाया जाता है. मैसेज में
कार्ड को इस तरह दिखाया जाता है
cardsV2
इसमें ये चीज़ें शामिल होती हैं:
- एक या एक से ज़्यादा
CardWithId
ऑब्जेक्ट. cardId
का इस्तेमाल, कार्ड की पहचान करने के लिए किया जाता है. साथ ही, यह दिए गए मैसेज के दायरे में आता है. (अलग-अलग मैसेज में मौजूद कार्ड का आईडी एक ही हो सकता है.)एक
card
ऑब्जेक्ट, जिसमें ये चीज़ें शामिल हैं:- एक
header
ऑब्जेक्ट जो टाइटल, सबटाइटल, और अवतार-स्टाइल इमेज जैसी चीज़ों के बारे में बताता है. - एक या एक से ज़्यादा
section
ऑब्जेक्ट और हर एक विजेट में कम से कम एक विजेट हो. - एक या एक से ज़्यादा
widget
ऑब्जेक्ट. हर विजेट एक कंपोज़िट ऑब्जेक्ट होता है, जो टेक्स्ट, इमेज, और अन्य ऑब्जेक्ट टाइप भी शामिल हैं.
- एक
उदाहरण के लिए, नीचे दिए गए कार्ड मैसेज में
header
section
, और
widget
ऑब्जेक्ट:
यह कोड, कार्ड मैसेज का JSON दिखाता है:
JSON
{
"cardsV2": [
{
"cardId": "unique-card-id",
"card": {
"header": {
"title": "Sasha",
"subtitle": "Software Engineer",
"imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
"imageType": "CIRCLE",
"imageAltText": "Avatar for Sasha"
},
"sections": [
{
"header": "Contact Info",
"collapsible": true,
"uncollapsibleWidgetsCount": 1,
"widgets": [
{
"decoratedText": {
"startIcon": {
"knownIcon": "EMAIL"
},
"text": "sasha@example.com"
}
},
{
"decoratedText": {
"startIcon": {
"knownIcon": "PERSON"
},
"text": "<font color=\"#80e27e\">Online</font>"
}
},
{
"decoratedText": {
"startIcon": {
"knownIcon": "PHONE"
},
"text": "+1 (555) 555-1234"
}
},
{
"buttonList": {
"buttons": [
{
"text": "Share",
"onClick": {
"openLink": {
"url": "https://example.com/share"
}
}
},
{
"text": "Edit",
"onClick": {
"action": {
"function": "goToView",
"parameters": [
{
"key": "viewType",
"value": "EDIT"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
Chat ऐप्लिकेशन के लिए, JSON कार्ड मैसेज डिज़ाइन करने और उनकी झलक देखने के लिए, Card Builder का इस्तेमाल करें:
कार्ड बिल्डर खोलें