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 đã 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 đại diện cho một thực thể nội dung đa phương tiện (tệp) được đính kèm vào một 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 đính kèm.

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

Node.js

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

Để không đồng bộ nhận siêu dữ liệu về tệp đính kèm trong tin nhắn trong Google Chat, hãy truyền nội dung sau vào 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 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ư.

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