Google Chat API 概览

本部分介绍了 Google Chat 应用如何 Chat API 让 Chat 应用可以执行诸多操作,例如 创建空间、向其中添加人员并发布消息。

身份验证

调用 Chat API 需要进行身份验证。每个 Chat API 方法需要 用户身份验证 (执行操作或访问 代表用户的数据)或 应用身份验证 (以 Chat 应用的形式执行操作或访问数据)。部分 方法同时支持用户身份验证和应用身份验证。

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

客户端库

建议大多数开发者调用 Google Chat API 是基于我们官方支持的 Cloud 客户端库 (例如 Python、Java 或 Node.js)。

如果您使用 Google Apps 脚本编写代码,请使用 高级 Chat 服务 而无需安装客户端库

Google Chat API 概念

gRPC 服务或 REST 资源和方法 授予对 Chat 聊天室、聊天室成员、消息和消息的访问权限 回应、消息附件、聊天室事件和用户阅读状态。

聊天室

聊天室是用户和应用相互交流和共享文件的地方。那里 是多种类型的聊天室私信 (DM) 是一对一对话 两位用户或一位用户与 Chat 应用之间来回切换。分组 聊天是指三位或更多用户之间的对话, 聊天应用。已命名的聊天室是用户长期在其中发送内容的位置, 共享文件和协作。

资源参考:

如需查看用法示例,请参阅:

成员

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

资源参考:

如需查看用法示例,请参阅:

信息

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

资源参考:

如需查看用法示例,请参阅:

回应

回应表示用户用于回应信息的表情符号,例如 👍?、🚲? 和 🌞?。

资源参考:

如需查看用法示例,请参阅:

媒体和附件

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

媒体资源参考(在 RPC 中不可用):

附件是指邮件中附加的媒体(文件)实例。

资源参考:

如需查看用法示例,请参阅:

聊天室事件

聊天室事件表示对聊天室或其 子资源,包括其成员、消息和回应。

资源参考:

如需查看用法示例,请参阅:

用户读取状态

用户读取状态是单例资源,表示有关 指定用户上次阅读的 Google Chat 聊天室消息或消息 线程。

空间读取状态资源参考:

线程读取状态资源参考文档:

如需查看用法示例,请参阅:

除了调用 Chat API 外,Chat 应用还可以: