本指南介绍了如何使用 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
实例,其中详细说明了指定消息附件的元数据。