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