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

本指南說明如何使用 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);
}

await main();

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

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