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 của tin nhắn. Phản hồi là một phiên bản 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 phần nội dung yêu cầu. Đây là tải trọng JSON đại diện cho sự kiện tương tác, bao gồm cả 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 cục bộ) 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 biểu thị một phiên bản của nội dung nghe nhìn (một tệp) được đính kèm vào tin nhắn. 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.

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

Node.js

Nhận tệp đính kèm trong thư

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

  • 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 tin nhắn.

Sau đây là cách lấy siêu dữ liệu về tệp đính kèm của 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);
}

await main();

Để 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 thư.

Chat API trả về một phiên bản của Attachment, trong đó nêu chi tiết siêu dữ liệu về tệp đính kèm thư được chỉ định.