Method: spaces.messages.create

在 Google Chat 聊天室中创建消息。如需查看示例，请参阅创建消息。

调用此方法需要身份验证，并且支持以下身份验证类型：

  • 对于短信，支持用户身份验证或应用身份验证。
  • 对于卡消息，仅支持应用身份验证。（只有 Chat 应用才能创建卡片消息。）

HTTP 请求

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要在其中创建消息的聊天室的资源名称。

格式：spaces/{space}

查询参数

参数
threadKey
(deprecated)

string

可选。已弃用：请改用 thread.thread_key。线程的 ID。最多支持 4000 个字符。如需发起或添加到话题，请创建消息并指定 threadKey 或 thread.name。如需查看示例，请参阅发起或回复消息会话。
requestId

string

可选。此消息的唯一请求 ID。指定现有请求 ID 将返回使用该 ID 创建的消息，而不是创建新消息。
messageReplyOption

enum (MessageReplyOption)

可选。指定消息是发起会话还是回复会话。仅在已命名的聊天室中受支持。
messageId

string

可选。创建时分配的 Chat 消息的自定义名称。必须以 client- 开头，并且只能包含小写字母、数字和连字符，长度不得超过 63 个字符。指定此字段以获取、更新或删除具有指定值的消息。分配自定义名称可让 Chat 应用找回消息，而不会保存创建消息时返回的响应正文中的消息 name。分配自定义名称不会替换生成的 name 字段，即消息的资源名称。而是将自定义名称设置为 clientAssignedMessageId 字段，您可以在处理后续操作（例如更新或删除消息）时引用。如需查看示例，请参阅为创建的消息命名。

请求正文

请求正文包含一个 Message 实例。

响应正文

如果成功，响应正文将包含一个新创建的 Message 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

如需了解详情，请参阅授权指南。

MessageReplyOption

指定如何回复消息。未来可能会添加更多州。

枚举
MESSAGE_REPLY_OPTION_UNSPECIFIED 默认。启动线程。
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD 创建消息，以回复 thread ID 或 threadKey 指定的会话。如果失败，消息将开始新会话。
REPLY_MESSAGE_OR_FAIL 创建消息，以回复 thread ID 或 threadKey 指定的会话。如果失败，则会返回 NOT_FOUND 错误。