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