دریافت فراداده در مورد پیوست پیام

این راهنما نحوه استفاده از متد get() در منبع Attachment از API چت گوگل را برای دریافت ابرداده‌های مربوط به یک پیوست پیام توضیح می‌دهد. پاسخ، نمونه‌ای از منبع Attachment است.

وقتی کاربر پیامی به برنامه شما ارسال می‌کند، گوگل چت یک رویداد تعاملی MESSAGE ارسال می‌کند. رویداد تعاملی که توسط برنامه شما دریافت می‌شود شامل یک بدنه درخواست است که همان JSON payload است که رویداد تعاملی، از جمله هرگونه پیوست، را نشان می‌دهد. داده‌های موجود در پیوست بسته به اینکه آیا پیوست محتوای آپلود شده (یک فایل محلی) است یا فایلی ذخیره شده در Drive، متفاوت است. منبع Media نشان‌دهنده فایل آپلود شده در گوگل چت، مانند تصاویر، ویدیوها و اسناد است. منبع Attachment نشان‌دهنده نمونه‌ای از رسانه - یک فایل - است که به یک پیام متصل شده است. منبع Attachment شامل ابرداده‌های مربوط به پیوست، مانند محل ذخیره آن است.

پیش‌نیازها

نود جی اس

دریافت پیوست پیام

برای دریافت ناهمگام فراداده‌های مربوط به پیوست پیام در Google Chat، موارد زیر را در درخواست خود ارسال کنید:

  • دامنه مجوز chat.bot را مشخص کنید.
  • متد GetAttachment() را فراخوانی کنید و name فایل پیوست پیام را به آن ارسال کنید.

در اینجا نحوه دریافت ابرداده در مورد پیوست پیام آمده است:

نود جی اس

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 را با نام پیوست پیام جایگزین کنید.

API چت نمونه‌ای از Attachment را برمی‌گرداند که جزئیات متادیتای مربوط به پیوست پیام مشخص شده را شرح می‌دهد.