设计卡片或对话框的组件

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

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

使用卡片制作工具设计和预览卡片。

打开卡片制作工具

卡片和对话框通常包含以下组成部分：

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

前提条件

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

    • 添加标头

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

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

    以下是 CardHeader 的示例：

    定义卡片的组成部分

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

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

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

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

    CardFixedFooter widget 仅适用于对话框。

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

    问题排查

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

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