本页介绍了如何在 Google Chat 中设计和创建卡片消息的主要界面组件。
卡片支持定义的布局、互动式界面元素(如按钮)和富媒体(如图片)。您可以使用卡片通过卡片消息和对话框来显示信息、收集意见或向用户提供后续步骤。
使用卡片构建器设计和预览聊天应用的 JSON 卡片消息:
打开卡片构建器卡片和对话框通常具有以下组件:
- 一个包含卡片标题的
CardHeader
。 - 一个或多个
CardSection
widget,它们构成卡片的正文。 - 仅适用于对话框的
CardFixedFooter
widget。
前提条件
添加标头
CardHeader
widget 表示卡片的标题。标题可以包含卡片的标题、副标题和头像图片。
以下是 CardHeader
的示例:
定义卡片的组成部分
CardSection
widget 是卡片内的一个高级容器。您可以使用卡片部分对卡片内的微件进行分组。对于每个卡片部分,您可以添加一个标题和一个或多个微件。
以下是包含两个 textParagraph
widget 的 CardSection
示例:
添加常驻页脚
CardFixedFooter
widget 代表 Chat 应用发送的对话框消息的页脚。页脚可以包含主按钮和辅助按钮。
CardFixedFooter
widget 仅适用于对话框。
下面是一个包含两个按钮的 CardFixedFooter
widget 示例:
排查问题
当 Google Chat 应用或卡片返回错误时,Chat 界面会显示一条消息,提示“出了点问题”。或“无法处理您的请求”。有时,Chat 界面不显示任何错误消息,但 Chat 应用或卡片会产生意外结果;例如,卡片消息可能不会显示。
虽然 Chat 界面中可能未显示错误消息,但当为 Chat 应用启用错误日志记录时,系统会提供描述性错误消息和日志数据来帮助您修复错误。如需查看、调试和修正错误方面的帮助,请参阅排查和修正 Google Chat 错误。