این صفحه یک نمای کلی درباره نحوه ساخت افزونههای Google Workspace که گپ Google را گسترش میدهند، ارائه میکند.
افزونههای Google Workspace که گپ را گسترش میدهند میتوانند به کاربران در انجام هر یک از موارد زیر کمک کنند:
- پیوندهای پیامهای چت را پیشنمایش کنید و بدون ترک مکالمه اقدام کنید.
- کارها را در سراسر برنامه های Google Workspace به صورت خودکار یا انجام دهید.
- دریافت هشدار یا اعلان در مورد ابزارها یا خدمات خارجی.
چگونه افزونههای Google Workspace در چت کار میکنند
در Chat، افزونهها بهعنوان برنامههای Google Chat برای کاربران ظاهر میشوند. برای تعامل با کاربران، برنامههای چت میتوانند کارهای زیر را انجام دهند:
- پیام هایی را ارسال کنید که حاوی متن، کارت و عناصر رابط کاربری تعاملی هستند.
- به دستورات اسلش پاسخ دهید.
- برای کمک به کاربران برای تکمیل فرآیندهای چند مرحله ای، مانند پر کردن داده های فرم، کادرهای گفتگو را باز کنید.
- پیشنمایش پیوندها در پیامها با پیوست کردن کارتهایی حاوی اطلاعات مفید که به کاربران امکان میدهد مستقیماً از مکالمه اقدام کنند.
شروع کنید
برای شروع ساخت افزونههای Google Workspace که در Chat کار میکنند، به اسناد زیر مراجعه کنید:
- با استفاده از Google Apps Script یا یک سرویس HTTP ، یک شروع سریع را امتحان کنید.
- یک برنامه چت و ویژگی های تعاملی آن را با استفاده از Chat API پیکربندی کنید .
- با روشهایی آشنا شوید که میتوانید با استفاده از محرکهای افزودنی، کنشها و اشیاء رویداد ، رابطهای چت بسازید .
محدودیت ها و مسائل شناخته شده
ویژگیهای چت و افزودنی زیر در دسترس نیستند:
- سرویس کارت برنامههای اسکریپت. برای استفاده از کنشهای گپ و ساخت کارتها، به جای آن اشیاء JSON را برگردانید. برای مثال، باز کردن گفتگوهای تعاملی و پیوندهای پیشنمایش را ببینید.
- کارت های مجوز سفارشی برای احراز هویت و اعطای مجوز به سرویس شما از Chat، برنامه Chat باید یک کارت مجوز اولیه را برگرداند.
- صفحات اصلی افزونه در نوار کناری چت. اگر یک راهانداز صفحه اصلی را برای برافزای خود پیکربندی کردهاید، صفحه اصلی فقط در نوار کناری سایر برنامههای Google Workspace که افزونه شما گسترش میدهد ظاهر میشود.
- صفحات اصلی برنامه چت ، که در برگه صفحه اصلی پیام های مستقیم با برنامه چت ظاهر می شوند.
اگر یک افزونه Google Workspace موجود را بهروزرسانی میکنید، الزامات پیکربندی زیر را برای برنامههای گپ در نظر بگیرید:
- تنظیمات نصب Google Workspace Marketplace باید به افراد و مدیران Google Workspace اجازه نصب این افزونه را بدهد.
- هر گونه تنظیمات پیکربندی رایج در مانیفست افزونه (
addons.common
) در چت نادیده گرفته می شود. برای پیکربندی افزونه برای کار در Chat، باید Chat API را فعال و پیکربندی کنید. برای مراحل، به پیکربندی برنامه Google Chat مراجعه کنید. - اگر در حال ساخت با سرویس HTTP هستید، باید API افزونههای Google Workspace را فعال کنید.
deployment
وproject
منابع REST فقط برای استقرارهای افزودنی در سایر برنامههای Google Workspace اعمال میشود. - برای استقرار و آزمایش یک افزونه در Chat، باید از تنظیمات Visibility Chat API استفاده کنید. هرگونه قابلیت مشاهده یا تنظیمات آزمایشی که در Google Workspace Marketplace SDK پیکربندی کردهاید نادیده گرفته میشود. برای استقرار نسخه آزمایشی افزونه در Chat، به آزمایش ویژگیهای تعاملی برای برنامههای Google Chat در اسناد Chat API مراجعه کنید.
- اگر افزونههای شما در Google Workspace Marketplace منتشر شدهاند، نمیتوانید پیشنویس تغییراتی را در تنظیمات پیکربندی Google Chat API ذخیره کنید. وقتی تنظیمات پیکربندی Chat API را بهروزرسانی میکنید، برنامه Chat بهروزرسانی شده بلافاصله در دسترس همه کاربران موجود است. برای بهروزرسانی فهرست بازار خود، میتوانید پیشنویسی را قبل از ارسال هرگونه تغییر ایجاد کنید .