Lấy siêu dữ liệu về tệp đính kèm trong tin nhắn

Hướng dẫn này giải thích cách sử dụng phương thức get() trên tài nguyên Attachment của API Google Chat để lấy siêu dữ liệu về tệp đính kèm trong tin nhắn. Phản hồi là một bản sao của tài nguyên Attachment.

Khi người dùng gửi tin nhắn đến ứng dụng của bạn, Google Chat sẽ gửi một sự kiện tương tác MESSAGE. Sự kiện tương tác mà ứng dụng của bạn nhận được bao gồm một nội dung yêu cầu, đó là tải trọng JSON đại diện cho sự kiện tương tác, bao gồm mọi tệp đính kèm. Dữ liệu trong tệp đính kèm sẽ khác nhau tuỳ thuộc vào việc tệp đính kèm đó là nội dung được tải lên (tệp trên máy) hay là tệp được lưu trữ trên Drive. Tài nguyên Media đại diện cho một tệp được tải lên Google Chat, chẳng hạn như hình ảnh, video và tài liệu. Tài nguyên Attachment đại diện cho một bản sao của nội dung nghe nhìn (tệp) được đính kèm vào thông báo. Tài nguyên Attachment bao gồm siêu dữ liệu về tệp đính kèm, chẳng hạn như vị trí lưu tệp đính kèm.

Điều kiện tiên quyết

Node.js

Nhận tệp đính kèm của thư

Để nhận siêu dữ liệu một cách không đồng bộ về một tệp đính kèm tin nhắn trong Google Chat, hãy chuyển nội dung sau vào yêu cầu:

  • Chỉ định phạm vi uỷ quyền chat.bot.
  • Gọi phương thức GetAttachment(), truyền name của tệp đính kèm thư.

Sau đây là cách lấy siêu dữ liệu về tệp đính kèm trong thư:

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);

Để chạy mẫu này, hãy thay thế spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME bằng tên tệp đính kèm của thư.

API Chat trả về một thực thể của Attachment trong đó nêu chi tiết siêu dữ liệu về tệp đính kèm tin nhắn đã chỉ định.