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