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