با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اشیاء Action به شما امکان می دهند رفتار تعاملی را در افزونه های Google Workspace ایجاد کنید. آنها تعریف می کنند که چه اتفاقی می افتد زمانی که کاربر با یک ویجت (به عنوان مثال، یک دکمه) در رابط کاربری افزونه تعامل می کند.
یک عملکرد با استفاده از یک تابع کنترل کننده ویجت به یک ویجت معین متصل می‌شود، که همچنین شرایطی را که اقدام را آغاز می‌کند، تعریف می‌کند. وقتی فعال می‌شود، عملکرد یک تابع بازخوانی تعیین‌شده را اجرا می‌کند. تابع callback به یک شی رویداد ارسال می شود که اطلاعات مربوط به تعاملات سمت مشتری کاربر را حمل می کند. شما باید تابع callback را پیاده سازی کنید و از آن بخواهید یک شی پاسخ خاص را برگرداند.
به عنوان مثال، می‌خواهید دکمه‌ای را می‌خواهید که با کلیک کردن، یک کارت جدید بسازد و نمایش دهد. برای این کار، باید یک ویجت دکمه جدید ایجاد کنید و از تابع کنترل کننده ابزارک دکمه setOnClickAction(action) برای تنظیم یک Action ساخت کارت استفاده کنید. Action که شما تعریف می‌کنید، یک تابع فراخوانی Apps Script را مشخص می‌کند که با کلیک روی دکمه اجرا می‌شود. در این حالت، تابع callback را برای ساخت کارت مورد نظر و برگرداندن یک شی ActionResponse پیاده سازی می کنید. شیء پاسخ به افزونه می‌گوید که کارتی را که تابع پاسخ به تماس ساخته شده است نمایش دهد.
این صفحه اقدامات ویجت مخصوص Gmail را که می‌توانید در برافزای خود قرار دهید، توضیح می‌دهد.
تعاملات جیمیل
افزونه‌های Google Workspace که Gmail را گسترش می‌دهند، می‌توانند شامل یک اقدام ویجت خاص Gmail برای نوشتن پیش‌نویس پیام‌ها باشند. این عمل به تابع مربوط به تماس پاسخ نیاز دارد تا یک شی پاسخ تخصصی را برگرداند:
برای استفاده از این اقدامات ویجت و اشیاء پاسخ، افزونه باید محدودهhttps://www.googleapis.com/auth/gmail.addons.current.action.compose را در مانیفست خود داشته باشد.
یک پیام بنویسید
یک افزونه Google Workspace که Gmail را گسترش می‌دهد، می‌تواند ویجتی را تعریف کند که در صورت تعامل با آن، پیام‌های پیش‌نویس را در Gmail ایجاد می‌کند (اعم از پیام‌های جدید یا پاسخ‌ها). برای انجام این کار، باید ویجت راه‌اندازی را با یک تابع callback مرتبط کنید که یک شی ComposeActionResponse برمی‌گرداند. هنگامی که عملکرد پاسخ به تماس به پایان رسید، Gmail از این شی پاسخ برای باز کردن و پر کردن پنجره نوشتن پیش نویس استفاده می کند.
تاریخ آخرین بهروزرسانی 2025-06-05 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-06-05 بهوقت ساعت هماهنگ جهانی."],[[["`Action` objects enable interactive behavior in Google Workspace add-ons by defining responses to user interactions with widgets."],["Actions are linked to widgets via handler functions and trigger callback functions that process user interactions and return response objects to update the add-on UI."],["Gmail add-ons have a specific action for composing draft messages, requiring a `ComposeActionResponse` object from the callback function and a specific scope in the add-on's manifest."],["Add-ons can generate draft messages in Gmail by associating a widget with a callback function that returns a `ComposeActionResponse` object, which Gmail uses to populate a draft compose window."]]],["`Action` objects in Google Workspace add-ons enable interactive behavior. An action, triggered by a widget interaction, executes a callback function. This function receives an event object with user interaction details and returns a response object. For instance, a button click can trigger a callback to build and display a new card. Gmail add-ons can use `ComposeActionResponse` to generate draft messages, triggered by widget interaction. The add-on must include the `https://www.googleapis.com/auth/gmail.addons.current.action.compose` scope for this.\n"]]
