此页面由 Cloud Translation API 翻译。

格式消息

Google Chat 可让您为消息设置格式，包括：

设置短信格式

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

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

形式	符号	示例语法	Google Chat 中显示的文字
粗体	*	你好	你好
斜体	_（下划线）	你好_	你好
删除线	~	~你好~	你好
等宽字体	`（反引号）	“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 字段中，包括以下内容：

以用户发送的以下文本为例：

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

如果消息是使用 Chat 界面中的格式菜单设置的，则 text 字段仅包含文本，而 formattedText 字段包含标记、文本和超链接。以下示例展示了一条文本消息草稿，其中包含一个带超链接的字词，而另一个字词以粗体显示：

包含字词的消息

收到的消息采用以下格式：

    {
      "text": "Be there at noon!",
      "formattedText": "Be <http://example.com|there> at *noon*",
    }

如果您在消息文本中包含纯文本链接网址（例如 http://www.example.com/），Google Chat 会将该网址用作链接文本，并自动将该文本链接到指定网址。

要为您的链接提供替代链接文字，请使用以下语法：

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

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

Chat 应用可以发送短信，用“@”提及 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 互动事件的 message.sender.name 字段。
如果您的 Google Chat 应用要创建异步短信，可以通过以下方式指定 users/{user} 的值：
- 使用 Google Chat User 资源的 name 字段，例如 users/123456789012345678901。
- 使用用户的电子邮件地址作为 {user} 值的别名。例如，如果电子邮件地址为 mahan@example.com，您可以将用户指定为 users/mahan@example.com。如需使用电子邮件别名，您的 Google Chat 应用必须以用户身份进行身份验证。
如果您使用 People API，还可以使用 people.get 方法来识别 User-ID。

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

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

在卡片内，大多数文本字段通过使用一小部分 HTML 标记来支持基本的文本格式设置。卡片消息中的文本格式与短信中的文本格式不同，因为文本消息的格式设置与 Chat 用户使用的语法相同。如需设置文本消息中显示的文本的格式，请参阅设置文本消息的格式。

下表中列出了支持的标记及其用途：

形式	示例	渲染结果
粗体	`"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>."`	时间格式：2023-02-16 15:00。
换行符	`"This is the first line. <br> This is a new line.` 英寸	这是第一行。。这是新的一行。

DecoratedText 和 ButtonList widget 支持 icon 元素，该元素用于指定 Chat 中提供的一个内置图标。

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

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

借助 DecoratedText 和 ButtonList widget，您可以使用内置图标或定义自己的自定义图标。如需指定自定义图标，请使用 iconUrl 元素，如以下示例所示：