REST Resource: spaces.messages

string

标识符。消息的资源名称。

格式：spaces/{space}/messages/{message}

其中，{space} 是发布消息的聊天室的 ID，{message} 是系统为消息分配的 ID。例如 spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB。

如果您在创建消息时设置了自定义 ID，则可以使用此 ID 在请求中指定消息，方法是将 {message} 替换为 clientAssignedMessageId 字段中的值。例如 spaces/AAAAAAAAAAA/messages/client-custom-name。如需了解详情，请参阅为消息命名。

object (User)

仅限输出。创建消息的用户。如果您的 Chat 应用以用户身份进行身份验证，则输出会填充 user name 和 type。

string (Timestamp format)

可选。不可变。对于在 Chat 中创建的聊天室，这是消息的创建时间。此字段仅限输出，在导入模式空间中使用时除外。

对于导入模式空间，请将此字段设置为消息在源中创建时的历史时间戳，以便保留原始创建时间。

string (Timestamp format)

仅限输出。用户上次修改消息的时间。如果消息从未经过修改，则此字段为空。

string (Timestamp format)

仅限输出。相应消息在 Google Chat 中被删除的时间。如果消息永远不会被删除，则此字段为空。

string

可选。邮件的纯文本正文。第一个指向图片、视频或网页的链接会生成预览条状标签。您还可以“@”提及 Google Chat 用户或聊天室中的所有人。

如需了解如何创建短信，请参阅发送消息。

string

仅限输出。包含添加了标记以传达格式设置信息的 text 消息。此字段可能无法捕获界面中显示的所有格式，但包含以下内容：

• 用于粗体、斜体、删除线、等宽字体、等宽字体块和项目符号列表的标记语法。

• 使用 <users/{user}> 格式的用户提及。

• 使用 <{url}|{rendered_text}> 格式的自定义超链接，其中第一个字符串是网址，第二个字符串是呈现的文本，例如 <http://example.com|custom text>。

• 使用 :{emojiName}: 格式的自定义表情符号，例如 :smile:。这不适用于 Unicode 表情符号，例如 U+1F600（表示咧嘴笑的表情符号）。

• 使用星号 (*) 列出项目符号列表项，例如 * item。

如需了解详情，请参阅查看消息中发送的文本格式

object (Card)

已弃用：请改用 cardsV2。

丰富、格式化且可互动的卡片，可用于显示界面元素，例如：格式化文本、按钮和可点击的图片。卡片通常显示在消息的纯文本正文下方。cards 和 cardsV2 的最大大小为 32 KB。

object (CardWithId)

可选。卡片数组。

只有 Chat 应用可以创建卡片。如果您的 Chat 应用以用户身份进行身份验证，则消息不能包含卡片。

如需了解如何创建包含卡片的邮件，请参阅发送邮件。

使用卡片构建器设计和预览卡片。

object (Annotation)

仅限输出。注释可以与邮件的纯文本正文相关联，也可以与链接到 Google Workspace 资源（例如 Google 文档或表格）的 chip 相关联，其中 startIndex 和 length 的值为 0。

object (Thread)

相应邮件所属的对话串。如需查看使用示例，请参阅发起或回复消息串。

object (Space)

仅限输出。如果 Chat 应用以用户身份进行身份验证，则输出仅填充 space name。

string

可选。消息卡片的纯文本说明，在无法显示实际卡片时使用，例如移动通知。

object (ActionResponse)

仅限输入。Chat 应用可用于配置其响应发布方式的参数。

string

仅限输出。消息的纯文本正文，其中已去除所有 Chat 应用提及内容。

object (SlashCommand)

仅限输出。斜杠命令信息（如果适用）。

object (Attachment)

可选。用户上传的附件。

object (MatchedUrl)

仅限输出。spaces.messages.text 中与链接预览格式匹配的网址。如需了解详情，请参阅预览链接。

boolean

仅限输出。如果值为 true，则表示相应消息是回复线程中的一条回复。如果值为 false，则相应消息会显示在聊天室的顶级对话中，作为话题的第 1 条消息或没有话题回复的消息。

如果聊天室不支持在话题中回复，则此字段始终为 false。

string

可选。消息的自定义 ID。您可以使用字段来标识消息，或获取、删除或更新消息。如需设置自定义 ID，请在创建消息时指定 messageId 字段。如需了解详情，请参阅为消息命名。

object (EmojiReactionSummary)

仅限输出。消息上的表情符号回应摘要列表。

object (User)

可选。不可变。用于创建消息的输入，否则仅为输出。可以查看消息的用户。如果设置了此字段，则消息为私密消息，仅对指定用户和 Chat 应用可见。如需在请求中添加此字段，您必须使用应用身份验证来调用 Chat API，并省略以下内容：

• 附件
• 配件 widget

如需了解详情，请参阅私下发送消息。

object (DeletionMetadata)

仅限输出。有关已删除消息的信息。设置 deleteTime 时，系统会删除消息。

object (QuotedMessageMetadata)

可选。有关另一条消息引用的消息的信息。

创建消息时，您可以引用同一话题中的消息，也可以引用根消息来创建新的根消息。不过，您无法引用其他消息串中的消息回复。

更新消息时，您无法添加或替换 quotedMessageMetadata 字段，但可以移除该字段。

如需查看使用示例，请参阅引用其他邮件。

object (AttachedGif)

仅限输出。附加到消息的 GIF 图片。

object (AccessoryWidget)

可选。显示在邮件底部的一个或多个互动 widget。您可以向包含文本、卡片或同时包含文本和卡片的消息添加辅助 widget。不支持包含对话框的消息。如需了解详情，请参阅在邮件底部添加互动式微件。

创建包含辅助功能 widget 的消息需要进行应用身份验证。