格式消息

Google Chat 可让您为消息添加格式，包括：

设置短信格式

Chat 可让您在文本消息中添加基本格式，包括 加粗、斜体和删除线，具体方法是使用 Markdown 语法的一小部分。您 文本消息和卡片消息中的文本格式不同， 消息格式与 Chat 采用的语法相同 。要设置卡片中显示的文字的格式，请参阅 设置卡片消息的格式。

如需设置文本消息的格式，请使用以下语法：

格式 符号 示例语法 Google Chat 中显示的文字
粗体 * *你好* 您好
斜体 _（下划线） _hello_ 您好
删除线 ~ ~你好~ 您好
等宽字体 `（反引号） “hello” hello
等宽块 ` ` `（三个反引号） ```
Hello
World
```		 Hello
World
项目符号列表 * 或 -（连字符），后接空格

* 这是列表中的第一项

* 这是列表中的第二项
  • 这是列表中的第一项
  • 这是列表中的第二项

例如，请参考以下 JSON：

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

带格式的文本消息在 Chat 中显示以下内容 空格：

Cymbal Pizza 应用会发送短信，表明已送达。

查看信息中发送的文本格式

当用户发送邮件时，邮件的纯文本正文位于 text 字段。使用 Markdown 应用于文本消息的某种格式 语法位于 text 字段中。其他格式位于 仅限输出的 formattedText 字段，其中包括：

  • 适用于文本的其他 Markdown 语法
  • 用户提及
  • 自定义超链接
  • 自定义表情符号

例如，假设用户发送了以下文本：

在 Chat 中收到了包含以下字词的消息

如果邮件是使用格式菜单的 聊天界面中，text 字段仅包含文本，而 formattedText 字段包含标记、文本和超链接。通过 以下示例显示了一条带超链接单词的草稿短信， 列表项，并将一个字词加粗：

包含以下字词的消息草稿

消息会按以下格式接收：

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

如果您在邮件文本中包含纯文本链接网址（如 http://www.example.com/，Google Chat 会将此内容作为链接文字， 自动将该文本超链接至指定网址。

要为链接提供备选链接文字，请使用以下语法：

示例语法 Google Chat 中显示的文字
<https://example.com|Example website>

竖线和链接文本是可选的，因此 <https://www.example.com/> 和 https://www.example.com/ 是等效的。

在短信中提及用户

聊天应用可以： 发送短信 用“@”提及 Chat 聊天室中的一位或所有用户。 聊天应用无法在 进入导入模式的空格或任何用户 尚未加入聊天室。

用“@”提及特定用户

如需用“@”提及特定用户，请在短信中添加 <users/{user}>，其中 {user} 是用户的 ID。例如，请考虑以下文本 消息，其中 123456789012345678901 表示用户 Mahan S 的 ID：

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

该文本消息如下所示：

Chat 应用在短信中提及了某个人。

您可以通过以下方式指定 users/{user} 值：

  • 如果您的 Google Chat 应用回复了 您可以使用message.sender.name MESSAGE 互动事件。

  • 如果您的 Google Chat 应用正在创建 异步短信 可以通过以下方式指定 users/{user} 的值：

    • 使用 Google Chat 的 name 字段 User 资源，例如 users/123456789012345678901。
    • 使用用户的电子邮件地址作为 {user} 值的别名。对于 例如，如果电子邮件地址为 mahan@example.com，您可以指定 将用户显示为 users/mahan@example.com。要使用电子邮件别名，您的 Google Chat 应用必须 以用户身份进行身份验证。

  • 如果您使用 People API，则还可以使用 people.get 方法 来标识用户 ID

用“@”提及所有用户

如要创建用“@”提及聊天室中的所有人的短信，请将“{user}”替换为 和all。以下 JSON 示例在消息中提及所有用户：

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

设置卡片消息的格式

在卡片内，大多数文本字段都支持基本的文本格式， 是 HTML 标记的子集。您为卡片消息和文本消息设置的格式不同 因为文本消息的语法 Chat 用户使用。要设置短信中显示的文本的格式，请按以下步骤操作： 请参阅 设置短信格式。

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

打开卡片制作工具

支持的代码及其用途如下所示 表：

格式 示例 呈现的结果
粗体 "This is <b>bold</b>." 此内容为粗体。
斜体 "This is <i>italics</i>." 这是斜体。
下划线 "This is <u>underline</u>." 这是下划线。
删除线 "This is <s>strikethrough</s>." 这部分是删除线。
字体颜色 "This is <font color=\"#FF0000\">red font</font>." 这是红色字体。
超链接 "This is a <a href=\"https://www.google.com\">hyperlink</a>." 这是一个超链接。
时间 "This is a time format: <time>2023-02-16 15:00</time>." 时间格式如下：。
换行符 "This is the first line. <br> This is a new line. 英寸 这是第一行。
另起一行。

为卡片添加内置图标

通过 DecoratedText 和 ButtonList widget 支持 icon 元素 用于指定“聊天”中可用的某个内置图标。

下表列出了可用于卡片消息的内置图标：

飞机 书签
公交车 汽车
时钟 CONFIRMATION_NUMBER_ICON
说明 美元
电子邮件 EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
酒店 HOTEL_ROOM_TYPE
INVITE MAP_PIN
会员资格 MULTIPLE_PEOPLE
用户 电话
RESTAURANT_ICON SHOPPING_CART
加星标 商店
票 训练
VIDEO_CAMERA VIDEO_PLAY

通过 以下为带有电子邮件图标的卡片示例：

向卡片中添加 Google Material Design 图标

通过 DecoratedText 和 ButtonList 你可以通过微件使用 Google Material 图标 这样您可以从 2500 多个图标选项中进行选择，并自定义 图标的粗细、填充和坡度

下面是一个带有 Google Material 图标的卡片示例：

向卡片添加自定义图标

通过 DecoratedText 和 ButtonList 微件可让您使用内置图标，或定义您自己的自定义图标。接收者 向卡片添加自定义图标，添加 iconUrl 字段并指定图标的 相应的网址

以下是自定义图标的示例：