设计卡片或对话框的组件

本页介绍了如何设计和创建卡片的主要界面组件 Google Chat 中的消息。

卡片支持定义的布局， 交互式界面元素，例如按钮，以及 图片等富媒体您可以使用卡片来展示信息、收集意见 或通过 卡片消息和 对话框。

使用卡片构建器设计和预览聊天应用的 JSON 卡片消息：

打开卡片制作工具

卡片和对话框通常具有以下组件：

  • 一个包含卡片标题的 CardHeader。
  • 一个或多个 CardSection widget，它们构成卡片的正文。
  • 仅适用于对话框的 CardFixedFooter widget。

前提条件

  • Google Workspace 账号 可访问 Google Chat。
  • 一款已发布的 Chat 应用。要构建 Chat 应用，关注此内容 快速入门。

    • 添加标头

    CardHeader widget 表示卡片的标题。标头可以包含 卡片的标题、副标题和头像图片。

    您可针对以下内容添加CardHeader： 卡片消息和 对话框。

    以下是 CardHeader 的示例：

    定义卡片的组成部分

    CardSection widget 是一个 卡片内的一个概要容器您使用卡 部分，对卡片内的微件进行分组。对于每个卡片部分，您都可以添加 以及一个或多个微件

    您可针对以下内容添加CardSection： 卡片消息和 对话框。

    以下是包含两个 textParagraph 的 CardSection 示例 微件：

    CardFixedFooter 微件表示由 Chat 应用。 页脚可以包含主按钮和辅助按钮。

    CardFixedFooter widget 仅适用于 对话框。

    下面是一个包含两个按钮的 CardFixedFooter widget 示例：

    问题排查

    当 Google Chat 应用或 card 会返回错误， 聊天界面会显示一条内容为“出了点问题”的消息。 或“无法处理您的请求”。有时，Chat 界面 不会显示任何错误消息，但 Chat 应用或 卡片会产生意外结果；例如，卡片消息 。

    虽然 Chat 界面中可能不会显示错误消息， 提供描述性错误消息和日志数据，以帮助您修正错误 启用 Chat 应用的错误日志记录时。如需观看方面的帮助， 请参阅 排查并修正 Google Chat 错误。