اشیاء Action به شما امکان می دهند رفتار تعاملی را در افزونه های Google Workspace ایجاد کنید. آنها تعریف می کنند که چه اتفاقی می افتد زمانی که کاربر با یک ویجت (به عنوان مثال، یک دکمه) در رابط کاربری افزونه تعامل می کند.
یک عملکرد با استفاده از یک تابع کنترل کننده ویجت به یک ویجت معین متصل می‌شود، که همچنین شرایطی را که اقدام را آغاز می‌کند، تعریف می‌کند. وقتی فعال می‌شود، عملکرد یک تابع بازخوانی تعیین‌شده را اجرا می‌کند. تابع callback به یک شی رویداد ارسال می شود که اطلاعات مربوط به تعاملات سمت مشتری کاربر را حمل می کند. شما باید تابع callback را پیاده سازی کنید و از آن بخواهید یک شی پاسخ خاص را برگرداند.
به عنوان مثال، می‌خواهید دکمه‌ای را می‌خواهید که با کلیک کردن، یک کارت جدید بسازد و نمایش دهد. برای این کار، باید یک ویجت دکمه جدید ایجاد کنید و از تابع کنترل کننده ابزارک دکمه setOnClickAction(action) برای تنظیم یک Action ساخت کارت استفاده کنید. Action که شما تعریف می‌کنید، یک تابع فراخوانی Apps Script را مشخص می‌کند که با کلیک روی دکمه اجرا می‌شود. در این حالت، تابع callback را برای ساخت کارت مورد نظر و برگرداندن یک شی ActionResponse پیاده سازی می کنید. شیء پاسخ به افزونه می‌گوید که کارتی را که تابع پاسخ به تماس ساخته شده است نمایش دهد.
این صفحه اقدامات ویجت مخصوص Gmail را که می‌توانید در برافزای خود قرار دهید، توضیح می‌دهد.
تعاملات جیمیل
افزونه‌های Google Workspace که Gmail را گسترش می‌دهند، می‌توانند یک اقدام ویجت خاص Gmail برای نوشتن پیش‌نویس پیام‌ها را شامل شوند. این عمل به تابع مربوط به تماس پاسخ نیاز دارد تا یک شی پاسخ تخصصی را برگرداند:
| اقدامی انجام شد | تابع Callback باید برگردد |
|---|---|
| پیش نویس پیام ها را بنویسید | ComposeActionResponse |
برای استفاده از این اقدامات ویجت و اشیاء پاسخ، افزونه باید محدوده https://www.googleapis.com/auth/gmail.addons.current.action.compose را در مانیفست خود داشته باشد.
یک پیام بنویسید
یک افزونه Google Workspace که Gmail را گسترش می‌دهد، می‌تواند ویجتی را تعریف کند که هنگام تعامل با آن، پیام‌های پیش‌نویس را در Gmail ایجاد کند (اعم از پیام‌های جدید یا پاسخ‌ها). برای انجام این کار، باید ویجت راه‌اندازی را با یک تابع callback مرتبط کنید که یک شی ComposeActionResponse را برمی‌گرداند. هنگامی که عملکرد پاسخ به تماس به پایان رسید، Gmail از این شی پاسخ برای باز کردن و پر کردن پنجره نوشتن پیش نویس استفاده می کند.
برای جزئیات بیشتر و یک مثال، به نوشتن پیام‌های پیش‌نویس مراجعه کنید.