取得郵件附件的相關中繼資料

本指南說明如何在 Google Chat API 的 Attachment 資源上使用 get() 方法，取得訊息附件的中繼資料。回應是 Attachment 資源的例項。

當使用者傳送訊息給您的應用程式時，Google Chat 會調度 MESSAGE 互動事件。應用程式收到的互動事件包含要求主體，這是代表互動事件的 JSON 酬載，包括任何附件。附件中的資料會因附件是上傳內容 (本機檔案) 或儲存在雲端硬碟中的檔案而有所不同。Media 資源代表上傳至 Google Chat 的檔案，例如圖片、影片和文件。Attachment 資源代表附加至訊息的媒體例項 (檔案)。Attachment 資源包含附件的中繼資料，例如儲存位置。

必要條件

Node.js

取得訊息附件

如要以非同步方式取得 Google Chat 訊息附件的中繼資料，請在要求中傳遞以下內容：

  • 指定 chat.bot 授權範圍。
  • 呼叫 GetAttachment() 方法，傳遞訊息附件的 name。

以下說明如何取得訊息附件的中繼資料：

Node.js

chat/client-libraries/cloud/get-attachment-app-cred.js
import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to get attachment metadata with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME, MESSAGE_NAME, and ATTACHMENT_NAME here
    name: 'spaces/SPACE_NAME/messages/MESSAGE_NAME/attachments/ATTACHMENT_NAME'
  };

  // Make the request
  const response = await chatClient.getAttachment(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

如要執行這個範例，請將 spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME 替換為訊息附件名稱。

Chat API 會傳回 Attachment 的例項，詳細說明指定訊息附件的中繼資料。