این راهنما نحوه استفاده از متد get() را در منبع Attachment Google Chat API برای دریافت فراداده درباره پیوست پیام توضیح میدهد. پاسخ نمونه ای از منبع Attachment است.
وقتی کاربر پیامی به برنامه شما ارسال میکند، Google Chat یک رویداد تعاملی MESSAGE را ارسال میکند. رویداد تعاملی که توسط برنامه شما دریافت میشود شامل یک بدنه درخواست است، که بار JSON نشاندهنده رویداد تعامل، از جمله هر پیوستی است. بسته به اینکه پیوست محتوای آپلود شده (فایل محلی) یا فایل ذخیره شده در Drive باشد، داده های پیوست متفاوت است. منبع Media فایلی را نشان میدهد که در چت Google آپلود شده است، مانند تصاویر، ویدیوها و اسناد. منبع Attachment نمونه ای از رسانه – یک فایل – را نشان می دهد که به یک پیام پیوست شده است. منبع Attachment شامل فراداده مربوط به پیوست است، مانند محل ذخیره آن.
پیش نیازها
Node.js
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- Node.js Cloud Client Library را نصب کنید.
- اعتبار حساب سرویس ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
credentials.jsonدر فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت برنامه پشتیبانی می کند.
یک پیوست پیام دریافت کنید
برای دریافت ناهمزمان فراداده مربوط به پیوست پیام در گپ Google، موارد زیر را در درخواست خود ارسال کنید:
- محدوده مجوز
chat.botرا مشخص کنید. - با ارسال
nameپیوست پیام، متدGetAttachment()را فراخوانی کنید.
در اینجا نحوه دریافت فراداده در مورد پیوست پیام آمده است:
Node.js
برای اجرای این نمونه، spaces/ SPACE_NAME /messages/ MESSAGE_NAME /attachments/ ATTACHMENT_NAME با نام پیوست پیام جایگزین کنید.
Chat API نمونهای از Attachment را برمیگرداند که فراداده مربوط به پیوست پیام مشخص شده را جزئیات میدهد.