REST Resource: spaces.messages

string

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

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

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

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

object (User)

仅限输出。消息的创建者。如果您的 Chat 应用以用户身份进行身份验证，输出将填充用户 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。

有关详情，请参阅查看邮件中发送的文本格式

object (Card)

已弃用：请改用 cardsV2。

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

object (CardWithId)

可选。卡片的数组。

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

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

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

object (Annotation)

仅限输出。与此消息中的 text 关联的注解。

object (Thread)

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

object (Space)

仅限输出。如果您的 Chat 应用以用户身份进行身份验证，输出内容只会填充聊天室 name。

string

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

object (ActionResponse)

仅限输入。Chat 应用可以使用这些参数来配置其响应的发布方式。

string

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

object (SlashCommand)

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

object (Attachment)

可选。用户上传的附件。

object (MatchedUrl)

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

boolean

仅限输出。如果设为 true，则表示消息是回复会话中的回复。设为 false 后，消息将在聊天室的顶级对话中显示为消息串中的第一条消息或没有话题式回复的消息。

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

string

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

object (EmojiReactionSummary)

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

object (User)

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

• 附件
• 配件微件

有关详情，请参阅私下发送消息。

object (DeletionMetadata)

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

object (QuotedMessageMetadata)

仅限输出。与 Google Chat 用户在聊天室中引用的消息相关的信息。Google Chat 用户可以引用消息来回复消息。

object (AttachedGif)

仅限输出。附加到邮件中的 GIF 图片。

object (AccessoryWidget)

可选。显示在邮件底部的一个或多个互动微件。您可以为包含文本、卡片或文本和卡片的消息添加配件微件。不支持包含对话框的消息。有关详情，请参阅在邮件底部添加互动微件。

若要创建包含配件 widget 的消息，您需要进行应用身份验证。