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

يوضّح هذا الدليل كيفية استخدام الأسلوب 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 الذي يوضّح البيانات الوصفية حول مرفق الرسالة المحدّد.