设计卡片或对话框的组件

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

卡片支持定义的布局、互动式界面元素（如按钮）和富媒体（如图片）。您可以使用卡片通过卡片消息和对话框来显示信息、收集意见或向用户提供后续步骤。

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

打开卡片构建器

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

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

前提条件

  • 一个有权访问 Google Chat 的 Google Workspace 帐号。
  • 一个已发布的 Chat 应用。如需构建 Chat 应用，请按照此quickstart进行操作。

    • 添加标头

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

    您可以为卡片消息和对话框添加 CardHeader。

    以下是 CardHeader 的示例：

    定义卡片的组成部分

    CardSection widget 是卡片内的一个高级容器。您可以使用卡片部分对卡片内的微件进行分组。对于每个卡片部分，您可以添加一个标题和一个或多个微件。

    您可以为卡片消息和对话框添加 CardSection。

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

    CardFixedFooter widget 代表 Chat 应用发送的对话框消息的页脚。页脚可以包含主按钮和辅助按钮。

    CardFixedFooter widget 仅适用于对话框。

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

    排查问题

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

    虽然 Chat 界面中可能未显示错误消息，但当为 Chat 应用启用错误日志记录时，系统会提供描述性错误消息和日志数据来帮助您修复错误。如需查看、调试和修正错误方面的帮助，请参阅排查和修正 Google Chat 错误。