تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك عناصر Action إنشاء سلوك
تفاعلي في إضافات Google Workspace. وتحدِّد هذه الإجراءات
ما يحدث عندما يتفاعل المستخدِم مع تطبيق مصغّر (مثل زر) في
واجهة مستخدم الإضافة.
يتم إرفاق إجراء بتطبيق مصغّر معيّن باستخدام
دالة معالِج التطبيق المصغّر،
التي تحدِّد أيضًا الشرط الذي يؤدي إلى تنفيذ الإجراء. عند بدء الإجراء، ينفذ الإجراء
دالة ردّ اتصال محدّدة.
يتمّ تمرير عنصر حدث يحمل معلومات عن تفاعلات المستخدِم من جهة العميل إلى الدالة المخصّصة للردّ. يجب تنفيذ دالة callback وجعلها تعرِض عنصر استجابة محدّدًا.
على سبيل المثال، لنفترض أنّك تريد زرًا ينشئ بطاقة جديدة ويعرضها عند
النقر عليه. ولإجراء ذلك، عليك إنشاء تطبيق مصغّر جديد للزر واستخدام دالّة معالج تطبيق مصغّر الزر
setOnClickAction(action)
لضبط Action لإنشاء البطاقات. إنّ القيمة التي تحدّدها لسمة
Action تحدّد دالة ردّ اتصال في Apps Script
يتم تنفيذها عند النقر على الزر. في هذه الحالة، يمكنك
تنفيذ دالة ردّ الاتصال لإنشاء البطاقة التي تريدها وعرض عنصر
ActionResponse. يطلب عنصر الاستجابة من الإضافة عرض البطاقة التي أنشأتها دالة callback.
توضّح هذه الصفحة إجراءات التطبيقات المصغّرة الخاصة بخدمة Gmail التي يمكنك تضمينها في
إضافة.
التفاعلات على Gmail
يمكن أن تتضمّن إضافات Google Workspace التي توفّر ميزات إضافية في Gmail
إجراء إضافي خاص بأداة Gmail لإنشاء مسودات الرسائل. يتطلّب هذا
الإجراء من دالة ردّ الاتصال
المرتبطة بالإجراء عرض عنصر استجابة مخصّص:
للاستفادة من إجراءات التطبيقات المصغّرة وكائنات الاستجابة هذه، يجب أن تشمل الإضافة
https://www.googleapis.com/auth/gmail.addons.current.action.composeالنطاق في ملف البيان الخاص بها.
إنشاء رسالة
يمكن أن تحدِّد إضافة Google Workspace التي تُوسِّع نطاق Gmail تطبيقات مصغّرة تُنشئ مسودات رسائل في Gmail عند التفاعل معها (إما رسائل جديدة أو ردود). لإجراء ذلك، عليك ربط الشاشة المشغِّلة
بدالة ردّ اتصال تعرض عنصرًا
ComposeActionResponse. عند انتهاء تنفيذ دالة الاستدعاء، يستخدم Gmail كائن الردّ
هذا لفتح نافذة إنشاء مسودة وملؤها.
لمزيد من التفاصيل والاطّلاع على مثال، يُرجى الاطّلاع على مقالة إنشاء مسودات الرسائل.
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["`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"]]
