Package google.apps.script.type.gmail

الفهرس

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

ComposeTrigger

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

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

DraftAccess

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

عمليات التعداد
UNSPECIFIED	القيمة التلقائية عندما لا يتم ضبط أي مسودة للوصول.
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 نقطة نهاية يتم استدعاؤها عندما يشغّل المستخدم الإجراء. راجع دليل الإجراءات العامة لمزيد من التفاصيل.