메시지 첨부파일에 관한 메타데이터 가져오기

이 가이드에서는 Google Chat API의 Attachment 리소스에서 get() 메서드를 사용하여 메시지 첨부파일에 관한 메타데이터를 가져오는 방법을 설명합니다. 응답은 Attachment 리소스의 인스턴스입니다.

사용자가 앱에 메시지를 보내면 Google Chat에서 MESSAGE 상호작용 이벤트를 디스패치합니다. 앱에서 수신한 상호작용 이벤트에는 첨부파일을 비롯한 상호작용 이벤트를 나타내는 JSON 페이로드인 요청 본문이 포함됩니다. 첨부파일의 데이터는 첨부파일이 업로드된 콘텐츠 (로컬 파일)인지 아니면 Drive에 저장된 파일인지에 따라 다릅니다. Media 리소스는 이미지, 동영상, 문서와 같이 Google Chat에 업로드된 파일을 나타냅니다. Attachment 리소스는 메시지에 첨부된 미디어(파일) 인스턴스를 나타냅니다. Attachment 리소스에는 첨부파일이 저장된 위치와 같은 첨부파일에 관한 메타데이터가 포함됩니다.

기본 요건

Node.js

메시지 첨부파일 가져오기

Google Chat에서 메시지 첨부파일에 관한 메타데이터를 비동기적으로 가져오려면 요청에 다음을 전달하세요.

  • chat.bot 승인 범위를 지정합니다.
  • 메시지 첨부파일의 name를 전달하여 GetAttachment() 메서드를 호출합니다.

다음은 메시지 첨부파일에 관한 메타데이터를 가져오는 방법입니다.

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 인스턴스를 반환합니다.