इस पेज पर टेक्स्ट और कार्ड मैसेज के बीच का अंतर बताया गया है.
जब 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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
कार्ड बिल्डर से कार्ड डिज़ाइन करें और उनकी झलक देखें.
कार्ड बिल्डर खोलें