Google Chat API 概览

本部分中的指南介绍了 Google Chat 应用如何调用 Chat API。借助该 API，Chat 应用可以执行创建聊天室、向聊天室添加人员和发布消息等操作，而无需收到 Chat 应用互动事件的提示。

身份验证

异步调用 Chat API 需要进行身份验证。每种 Chat API 方法都需要进行用户身份验证（以代表用户执行操作或访问数据）或应用身份验证（以 Chat 应用的形式执行操作或访问数据）。某些方法同时支持用户身份验证和应用身份验证。

如需详细了解 Chat 中的身份验证，请参阅身份验证概览。

API 资源和方法

借助 REST 资源和方法，您可以异步访问 Chat 聊天室、聊天室成员、消息、消息回应和消息附件。

聊天室

聊天室是用户和应用可以聊天和共享文件的地方。聊天室有多种类型。私信 (DM) 是指两位用户或一位用户与某款 Chat 应用之间的一对一对话。群聊是指三位或多位用户和 Chat 应用之间的对话。命名的聊天室是用户发送消息、共享文件和协作的永久位置。

Space 资源表示一个空间。

聊天室支持以下方法：

成员

成员是指已加入或受邀加入聊天室的用户和聊天应用。

Member 资源代表一个成员。

成员支持以下方法：

信息

消息包括在聊天室中发布的文本和卡片通信。消息中可附加文件。 用户可以在消息中附加表情符号来回应消息。

Message 资源表示消息。

消息支持以下方法：

回应

回应是指用户用来回应消息的表情符号，例如 👍?、🚲? 和 🌞?。

Reaction 资源表示回应。

回应支持以下方法：

媒体和附件

“媒体”表示上传到 Google Chat 的文件，例如图片、视频和文档。

Media 资源表示附加到消息的媒体。

附件是邮件中附加的媒体（文件）实例。

Attachment 资源代表一个连接。附件包含附加到消息的媒体和关联的元数据。

媒体和附件支持以下方法：

找到发现文档

此 API 的发现文档位于以下网址：