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

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

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

await main();

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

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