تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك عناصر Action إنشاء سلوك
تفاعلي في إضافات Google Workspace. وتحدِّد هذه الإجراءات
ما يحدث عندما يتفاعل المستخدِم مع تطبيق مصغّر (مثل زر) في
واجهة مستخدم الإضافة.
يتم إرفاق إجراء بتطبيق مصغّر معيّن باستخدام
دالة معالِج التطبيق المصغّر،
التي تحدِّد أيضًا الشرط الذي يؤدي إلى تنفيذ الإجراء. عند بدء الإجراء، ينفذ الإجراء
دالة ردّ اتصال محدّدة.
يتم تمرير عنصر حدث يحمل معلومات حول تفاعلات المستخدم من جهة العميل إلى دالة الاستدعاء. يجب تنفيذ دالة callback وجعلها تعرِض عنصر استجابة محدّدًا.
على سبيل المثال، لنفترض أنّك تريد زرًا ينشئ بطاقة جديدة ويعرضها عند
النقر عليه. ولإجراء ذلك، عليك إنشاء تطبيق مصغّر جديد للزرّ واستخدام دالّة معالج تطبيق مصغّر الزرّ
setOnClickAction(action)
لضبط Action لإنشاء البطاقات. إنّ القيمة التي تحدّدها لسمة
Action تحدّد دالة ردّ اتصال في Apps Script تتم تنفيذها عند النقر على الزر. في هذه الحالة، يمكنك
تنفيذ دالة ردّ الاتصال لإنشاء البطاقة التي تريدها وعرض عنصر
ActionResponse. يطلب عنصر الاستجابة من الإضافة عرض البطاقة التي تم إنشاء دالة ردّ الاتصال
لها.
توضّح هذه الصفحة إجراءات التطبيقات المصغّرة الخاصة بخدمة Gmail التي يمكنك تضمينها في
إضافة.
التفاعلات على Gmail
يمكن أن تتضمّن إضافات Google Workspace التي توفّر ميزات إضافية في Gmail
إجراء إضافي خاص بأداة Gmail لإنشاء مسودات الرسائل. يتطلّب هذا
الإجراء من دالة ردّ الاتصال
المرتبطة بالإجراء عرض عنصر استجابة مخصّص:
للاستفادة من إجراءات التطبيقات المصغّرة وكائنات الاستجابة هذه، يجب أن تشمل الإضافة
https://www.googleapis.com/auth/gmail.addons.current.action.composeالنطاق في ملف البيان الخاص بها.
إنشاء رسالة
يمكن أن تحدِّد إضافة Google Workspace التي توفّر ميزات إضافية في Gmail تطبيقات مصغّرة تُنشئ مسودات رسائل في Gmail عند التفاعل معها (إما رسائل جديدة أو ردود). لإجراء ذلك، يجب ربط الشاشة المشغِّلة
بدالة ردّ اتصال تعرض عنصرًا
ComposeActionResponse. عند انتهاء تنفيذ دالة الاستدعاء، يستخدم Gmail كائن الردّ
هذا لفتح نافذة إنشاء مسودة وملؤها.
لمزيد من التفاصيل والاطّلاع على مثال، يُرجى الاطّلاع على مقالة
إنشاء مسودات الرسائل.
تاريخ التعديل الأخير: 2025-06-06 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-06 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eAction\u003c/code\u003e objects enable interactive behavior in Google Workspace add-ons by defining responses to user interactions with widgets.\u003c/p\u003e\n"],["\u003cp\u003eActions 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.\u003c/p\u003e\n"],["\u003cp\u003eGmail add-ons have a specific action for composing draft messages, requiring a \u003ccode\u003eComposeActionResponse\u003c/code\u003e object from the callback function and a specific scope in the add-on's manifest.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons can generate draft messages in Gmail by associating a widget with a callback function that returns a \u003ccode\u003eComposeActionResponse\u003c/code\u003e object, which Gmail uses to populate a draft compose window.\u003c/p\u003e\n"]]],["`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"],null,["# Gmail actions\n\n[`Action`](/workspace/add-ons/concepts/actions) objects let you build interactive\nbehavior into Google Workspace add-ons. They define\nwhat happens when a user interacts with a widget (for example, a button) in\nthe add-on UI.\n\nAn action is attached to a given widget using a\n[widget handler function](/workspace/add-ons/concepts/actions#widget_handler_functions),\nwhich also defines the condition that triggers the action. When triggered, the\naction executes a designated\n[callback function](/workspace/add-ons/concepts/actions#callback_functions).\nThe callback function is passed an\n[event object](/workspace/add-ons/concepts/event-objects) that carries\ninformation about the user's client-side interactions. You must implement the\ncallback function and have it return a specific response object.\n\nFor example, say you want a button that builds and displays a new card when\nclicked. For this, you must create a new button widget and use the button widget\nhandler function\n[`setOnClickAction(action)`](/apps-script/reference/card-service/text-button#setOnClickAction(Action))\nto set a card-building [`Action`](/workspace/add-ons/concepts/actions). The\n[`Action`](/workspace/add-ons/concepts/actions) you define specifies an Apps Script\ncallback function that executes when the button is clicked. In this case, you\nimplement the callback function to build the card you want and return an\n[`ActionResponse`](/apps-script/reference/card-service/action-response)\nobject. The response object tells the add-on to display the card the callback\nfunction built.\n\nThis page describes Gmail-specific widget actions you can include in your\nadd-on.\n\nGmail interactions\n------------------\n\nGoogle Workspace add-ons that extend Gmail can include\nan additional Gmail-specific widget action to compose draft messages. This\naction requires the associated action\n[callback function](/workspace/add-ons/concepts/actions#callback_functions)\nto return a specialized response object:\n\n| Action attempted | Callback function should return |\n|------------------------------------------------------------|----------------------------------------------------------------------------------------|\n| [Compose draft messages](/workspace/add-ons/gmail/compose) | [`ComposeActionResponse`](/apps-script/reference/card-service/compose-action-response) |\n\nTo make use of these widget actions and response objects, the add-on must\ninclude the\n`https://www.googleapis.com/auth/gmail.addons.current.action.compose`\n[scope](/workspace/add-ons/concepts/workspace-scopes#gmail_add-on_scopes) in its manifest.\n\n### Compose a message\n\nA Google Workspace add-on that extends Gmail can\ndefine a widget that, when interacted with, generates draft messages in Gmail\n(either new messages or replies). To do this, you must associate the triggering\nwidget with a callback function that returns a\n[`ComposeActionResponse`](/apps-script/reference/card-service/compose-action-response)\nobject. When the callback function finishes executing, Gmail uses this\nresponse object to open and populate a draft compose window.\n\nFor more details and an example, see\n[Compose draft messages](/workspace/add-ons/gmail/compose).\n| **Note:** This behavior is distinct from [extending the compose window UI](/workspace/add-ons/gmail/extending-compose-ui). In that case the add-on is creating a contextual card interface alongside the compose window. Here, a draft is generated in response to a widget interaction."]]
