本指南介绍了如何对 Google Chat API 的 Attachment
资源使用 get()
方法来获取有关消息附件的元数据。响应是 Attachment
资源的实例。
当用户向您的应用发送消息时,Google Chat 会分派 MESSAGE
互动事件。您的应用收到的互动事件包含请求正文,即表示互动事件的 JSON 载荷,包括所有附件。附件中的数据因附件是上传内容(本地文件)还是存储在云端硬盘中的文件而异。Media
资源表示上传到 Google Chat 的文件,例如图片、视频和文档。Attachment
资源表示附加到消息中的媒体实例(文件)。Attachment
资源包含有关附件的元数据,例如其保存位置。
前提条件
Node.js
- 拥有对 Google Chat 访问权限的商务版或企业版 Google Workspace 账号。
- 设置环境:
- 创建 Google Cloud 项目。
- 配置 OAuth 同意屏幕。
- 启用和配置 Google Chat API,为 Chat 应用提供名称、图标和说明。
- 安装 Node.js Cloud 客户端库。
-
创建服务账号凭据。如需运行本指南中的示例,请将凭据保存为名为
credentials.json
的 JSON 文件,并保存到本地目录。
- 选择支持应用身份验证的授权范围。
获取消息附件
如需异步获取 Google Chat 中消息附件相关的元数据,请在请求中传递以下内容:
- 指定
chat.bot
授权范围。 - 调用
GetAttachment()
方法,传递邮件附件的name
。
如需获取有关邮件附件的元数据,请按以下步骤操作:
Node.js
如需运行此示例,请将 spaces/SPACE_NAME/messages/
MESSAGE_NAME/attachments/ATTACHMENT_NAME
替换为邮件附件名称。
Chat API 会返回一个 Attachment
实例,其中详细说明了指定消息附件的元数据。