本页介绍了如何设计和创建卡片的主要界面组件 Google Chat 中的消息。
卡片支持定义的布局, 交互式界面元素,例如按钮,以及 图片等富媒体您可以使用卡片来展示信息、收集意见 或通过 卡片消息和 对话框。
使用卡片构建器设计和预览聊天应用的 JSON 卡片消息:
打开卡片制作工具卡片和对话框通常具有以下组件:
- 一个包含卡片标题的
CardHeader
。 - 一个或多个
CardSection
widget,它们构成卡片的正文。 - 仅适用于对话框的
CardFixedFooter
widget。
前提条件
一款已启用互动功能的 Google Chat 应用。要创建 交互式 Chat 应用,请完成以下快速入门之一 针对您要使用的应用架构:
- 将 HTTP 服务与 Google Cloud Functions 搭配使用
- Google Apps 脚本
- Google Cloud Dialogflow CX
- Google Cloud Pub/Sub
添加标头
CardHeader
widget
表示卡片的标题。标头可以包含
卡片的标题、副标题和头像图片。
您可针对以下内容添加CardHeader
:
卡片消息和
对话框。
以下是 CardHeader
的示例:
定义卡片的组成部分
CardSection
widget 是一个
卡片内的一个概要容器您使用卡
部分,将卡片内的微件分组。对于每个卡片部分,您都可以添加
以及一个或多个微件
您可针对以下内容添加CardSection
:
卡片消息和
对话框。
以下是包含两个 textParagraph
的 CardSection
示例
微件:
添加常驻页脚
CardFixedFooter
微件表示由
Chat 应用。
页脚可以包含主按钮和辅助按钮。
CardFixedFooter
widget 仅适用于
对话框。
下面是一个包含两个按钮的 CardFixedFooter
widget 示例:
问题排查
当 Google Chat 应用或 card 会返回错误, 聊天界面会显示一条内容为“出了点问题”的消息。 或“无法处理您的请求”。有时,Chat 界面 不会显示任何错误消息,但 Chat 应用或 卡片会产生意外结果;例如,卡片消息 。
虽然 Chat 界面中可能不会显示错误消息, 提供描述性错误消息和日志数据,以帮助您修正错误 启用 Chat 应用的错误日志记录时。如需观看方面的帮助, 请参阅 排查并修正 Google Chat 错误。