الحصول على البيانات الوصفية حول مرفق رسالة

يشرح هذا الدليل كيفية استخدام الطريقة get() على المورد Attachment من Google Chat API للحصول على بيانات وصفية حول مرفق رسالة. الردّ هو نسخة افتراضية من مورد "Attachment".

عندما يرسل المستخدم رسالة إلى تطبيقك، تُرسِل Google Chat MESSAGE حدث تفاعل. يتضمّن حدث التفاعل الذي يتلقّاه تطبيقك نص الطلب، وهو ملف حمولة JSON يمثّل حدث التفاعل، بما في ذلك أي مرفقات. تختلف data في المرفق حسب ما إذا كان المرفق هو محتوى تم تحميله (ملف محلي) أو ملف مخزّن على Drive. يمثّل مورد 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);
}

main().catch(console.error);

لتنفيذ هذا العيّنة، استبدِل spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME باسم مرفق الرسالة.

تعرض واجهة Chat API مثيلاً من Attachment يوضح بالتفصيل البيانات الوصفية لمرفق الرسالة المحدّد.