本页面介绍了短信消息和卡片消息之间的区别。
当 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
,用于标识卡片并在给定消息中限定范围。 (不同消息中的卡片可以具有相同的 ID。)card
对象,其中包含以下内容:- 一个
header
对象 用于指定标题、副标题和头像样式的图片等内容。 - 一个或多个
section
对象 每个容器至少包含一个 widget。 - 一个或多个
widget
对象。 每个 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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
使用卡片构建器设计和预览聊天应用的 JSON 卡片消息:
打开卡片制作工具