الفهرس
ComposeTrigger
(رسالة)ComposeTrigger.DraftAccess
(تعداد)ContextualTrigger
(رسالة)GmailAddOnManifest
(رسالة)UnconditionalTrigger
(رسالة)UniversalAction
(رسالة)
ComposeTrigger
عامل تشغيل يتم تفعيله عندما ينشئ المستخدم رسالة إلكترونية.
الحقول | |
---|---|
actions[] |
تحدِّد هذه السياسة مجموعة الإجراءات الخاصة بإضافة وقت الإنشاء. هذه هي الإجراءات التي يمكن للمستخدمين تشغيلها في إضافة وقت الإنشاء. |
draftAccess |
تحدِّد هذه السياسة مستوى الوصول إلى البيانات عند تفعيل إضافة وقت الإنشاء. |
DraftAccess
تعداد يحدد مستوى الوصول إلى البيانات الذي يتطلبه مشغل الإنشاء.
عمليات التعداد | |
---|---|
UNSPECIFIED |
القيمة التلقائية عندما لا يتم ضبط أي مسودة للوصول. |
NONE |
لا يمكن لمشغِّل الإنشاء الوصول إلى أي بيانات في المسودة عند تشغيل إضافة إنشاء. |
METADATA |
يتم منح مشغّل الإنشاء الإذن بالوصول إلى البيانات الوصفية للمسودة عند تشغيل إضافة إنشاء. ويشمل ذلك قائمة المستخدمين، مثل القائمة "إلى" و"نسخة إلى" لمسودة رسالة. |
ContextualTrigger
يحدد مشغلاً يتم تنشيطه عندما تفي رسالة البريد الإلكتروني المفتوحة بمعايير محددة. عندما يتم تنشيط المشغِّل، فإنه ينفِّذ نقطة نهاية محددة، وذلك عادةً لإنشاء بطاقات جديدة وتحديث واجهة المستخدم.
الحقول | |
---|---|
onTriggerFunction |
مطلوبة. اسم نقطة النهاية المطلوب طلبها عندما تتطابق رسالة مع المشغِّل. |
حقل الاتحاد trigger يحدد نوع المشغِّل الشروط التي يستخدمها Gmail لعرض الإضافة. يمكن أن تكون السمة "trigger " واحدة فقط مما يلي: |
|
unconditional |
يتم تنفيذ المشغلات غير الشرطية عند فتح أي رسالة بريد. |
GmailAddOnManifest
المواقع التي تخصِّص مظهر إضافة Gmail وتنفيذها
الحقول | |
---|---|
homepageTrigger |
تحدد نقطة نهاية سيتم تنفيذها في سياقات لا تتطابق مع مشغِّل سياقي مُعلَن عنه. ستكون أي بطاقات يتم إنشاؤها من خلال هذه الوظيفة متاحة للمستخدم دائمًا، ولكن قد يحجبها المحتوى السياقي عندما تعرض هذه الإضافة عوامل تشغيل أكثر استهدافًا. وفي حال توفُّرها، سيتم إلغاء الإعدادات من |
contextualTriggers[] |
تحدِّد هذه السياسة مجموعة الشروط التي تؤدي إلى تفعيل الإضافة. |
universalActions[] |
لتحديد مجموعة من الإجراءات العامة للإضافة. يشغّل المستخدم الإجراءات العامة من قائمة شريط أدوات الإضافات. |
composeTrigger |
تحدِّد هذه السياسة مشغِّل وقت الإنشاء للإضافة المخصّصة لوقت الإنشاء. هذا هو المشغِّل الذي يتسبب في اتخاذ الإضافة لإجراء عند إنشاء المستخدم لرسالة إلكترونية. يجب أن تشتمل جميع إضافات وقت الإنشاء على النطاق |
authorizationCheckFunction |
اسم نقطة النهاية التي تتحقّق من أنّ الإضافة تتضمّن جميع تفويضات الجهات الخارجية المطلوبة، من خلال فحص واجهات برمجة التطبيقات التابعة لجهة خارجية إذا تعذّر إجراء الفحص، يجب أن تقدِّم الدالة استثناءً لبدء تدفق التفويض. يتم استدعاء هذه الدالة قبل كل استدعاء للإضافة لضمان تجربة سلسة للمستخدم. |
UnconditionalTrigger
لا يحتوي هذا النوع على أي حقول.
عامل تشغيل يتم تنشيطه عند فتح أي رسالة بريد إلكتروني.
UniversalAction
يشير هذا المصطلح إلى إجراء متاح دائمًا في قائمة شريط أدوات الإضافات بغض النظر عن سياق الرسالة.
الحقول | |
---|---|
text |
مطلوبة. نص يظهر للمستخدم يصف الإجراء، مثل "إضافة جهة اتصال جديدة". |
حقل الاتحاد action_type يحدد نوع الإجراء سلوك Gmail عند استدعاء المستخدم للإجراء. يمكن أن تكون السمة "action_type " واحدة فقط مما يلي: |
|
openLink |
رابط يتم فتحه من خلال Gmail عندما يشغِّل المستخدم الإجراء. |
runFunction |
نقطة نهاية يتم استدعاؤها عندما يشغّل المستخدم الإجراء. راجع دليل الإجراءات العامة لمزيد من التفاصيل. |