این راهنما نحوه استفاده از متد 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
را برمیگرداند که فراداده مربوط به پیوست پیام مشخص شده را جزئیات میدهد.