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