Package google.apps.script.type.gmail

الفهرس

• ComposeTrigger (رسالة)
• ComposeTrigger.DraftAccess (تعداد)
• ContextualTrigger (رسالة)
• GmailAddOnManifest (رسالة)
• UnconditionalTrigger (رسالة)
• UniversalAction (رسالة)

ComposeTrigger

عامل تشغيل يتم تفعيله عندما يُنشئ المستخدِم رسالة إلكترونية.

الحقول
actions[]	MenuItemExtensionPoint تحدِّد مجموعة الإجراءات لإضافة وقت الإنشاء. هذه هي الإجراءات التي يمكن للمستخدمين تفعيلها في إحدى الإضافات الخاصة بوقت الكتابة.
draftAccess	DraftAccess يحدِّد مستوى الوصول إلى البيانات عند بدء إضافة وقت إنشاء.

DraftAccess

فهرس يحدّد مستوى الوصول إلى البيانات الذي يتطلّبه عامل تشغيل الإنشاء

عمليات التعداد
UNSPECIFIED	القيمة التلقائية عند عدم ضبط أيّ قيمة لـ draftAccess
NONE	لا يمكن لعامل تشغيل الإنشاء الوصول إلى أي بيانات من المسودة عند بدء إحدى الإضافات الخاصة بالإنشاء.
METADATA	يمنح هذا الإذن عامل التشغيل "الإنشاء" إذن الوصول إلى البيانات الوصفية للمسودة عند بدء إضافة إنشاء. ويشمل ذلك قائمة الجمهور، مثل قائمة "إلى" و"نسخة إلى" في مسودة رسالة.

ContextualTrigger

يحدِّد مشغِّل يتم تفعيله عندما تستوفي الرسالة الإلكترونية المفتوحة معايير معيّنة. عند بدء تشغيل المشغِّل، يتم تنفيذ نقطة نهاية معيّنة، عادةً لإنشاء بطاقات جديدة وتعديل واجهة المستخدم.

الحقول
onTriggerFunction	string مطلوب. اسم نقطة النهاية المطلوب الاتصال بها عندما تتطابق رسالة مع عامل التفعيل.
حقل الربط trigger يحدّد نوع العامل المشغِّل الشروط التي يستخدمها Gmail لعرض الإضافة. يمكن أن يكون trigger واحدًا فقط مما يلي:
unconditional	UnconditionalTrigger يتم تنفيذ عوامل التفعيل غير المشروطة عند فتح أي رسالة بريد إلكتروني.

GmailAddOnManifest

السمات التي تخصّص مظهر إضافة Gmail وتنفيذها

الحقول
homepageTrigger	HomepageExtensionPoint تحدِّد نقطة نهاية سيتم تنفيذها في السياقات التي لا تتطابق مع عامل تشغيل سياقي مُعلَن. وستظلّ أيّ بطاقات يتم إنشاؤها بواسطة هذه الوظيفة متاحة للمستخدم في جميع الأوقات، ولكن قد يتم حجبها بواسطة المحتوى السياقي عندما تُعلن هذه الإضافة عن عوامل تشغيل أكثر استهدافًا. في حال توفّر هذا الإعداد، يتم تجاهل الإعداد من addOns.common.homepageTrigger.
contextualTriggers[]	ContextualTrigger تحدِّد مجموعة الشروط التي تؤدي إلى تنشيط الإضافة.
universalActions[]	UniversalAction تُحدِّد مجموعة من الإجراءات العامة للإضافة. يشغّل المستخدم الإجراءات الشاملة من قائمة شريط أدوات الإضافة.
composeTrigger	ComposeTrigger يحدِّد عامل التفعيل الخاص بوقت إنشاء الرسالة لإضافة وقت إنشاء الرسالة. هذا هو العامل المشغِّل الذي يدفع الإضافة إلى اتّخاذ إجراء عندما يُنشئ المستخدم رسالة إلكترونية. يجب أن يكون لجميع الإضافات في وقت الكتابة نطاق gmail.addons.current.action.compose حتى لو لم تكن تُعدِّل المسودة.
authorizationCheckFunction	string اسم نقطة نهاية للتحقّق من أنّ الإضافة لديها جميع الأذونات المطلوبة التابعة لجهات خارجية، وذلك من خلال فحص واجهات برمجة التطبيقات التابعة لجهات خارجية إذا تعذّر إجراء عملية الفحص، من المفترض أن تُرسِل الدالة استثناءً لبدء عملية التفويض. يتمّ استدعاء هذه الدالة قبل كلّ استدعاء للإضافة لضمان تجربة سلسة للمستخدم.

UnconditionalTrigger

لا يحتوي هذا النوع على أي حقول.

عامل تشغيل يتم تفعيله عند فتح أي رسالة إلكترونية.

UniversalAction

إجراء متاح دائمًا في قائمة شريط أدوات الإضافة بغض النظر عن سياق الرسالة

الحقول
text	string مطلوب. نص مرئي للمستخدم يصف الإجراء، على سبيل المثال، "إضافة جهة اتصال جديدة"
حقل الربط action_type يحدِّد نوع الإجراء سلوك Gmail عندما ينفّذ المستخدم الإجراء. يمكن أن يكون action_type واحدًا فقط مما يلي:
openLink	string رابط يفتحه Gmail عندما ينفّذ المستخدم الإجراء.
runFunction	string نقطة نهاية يتمّ استدعاؤها عندما يُشغّل المستخدِم الإجراء. اطّلِع على دليل الإجراءات العامة للاطّلاع على التفاصيل.