مورد بيان Gmail

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إعدادات الموارد التي تُستخدَم لتحديد المحتوى والسلوك Google Workspace الإضافة في Gmail. Google Workspace يجب أن تشتمل بيان الإضافة على جميع المكوّنات التي تم وضع علامة عليها باعتبارها مطلوبة في حال توسيع Gmail.

Gmail

إعدادات Google Workspace البيان الإضافي لإضافات Gmail. يمكنك الاطّلاع على تمديد Gmail باستخدام Google Workspace الإضافات للحصول على مزيد من المعلومات.

تمثيل JSON
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
الحقول
authorizationCheckFunction

string

متوقف. اسم دالة "برمجة تطبيقات Google" التي تُجري عمليات تحقّق من متطلبات تفويض الجهات الخارجية. تُسمى هذه الدالة قبل كل استدعاء Google Workspace للإضافة.

تم إيقاف هذه الدالة لتجنّب وقت استجابة التنفيذ غير الضروري. بدلاً من ذلك، يجب أن تستبعد الإضافة استثناءً من الاستدعاء الرئيسي، كما هو موضّح في هذا المثال.

composeTrigger

object (ComposeTrigger)

مطلوب لإنشاء الإجراءات. تحدِّد هذه السياسة مجموعة واجهات المستخدم المتاحة للمستخدم أثناء إنشاء رسالة إلكترونية.

يمكنك الاطّلاع على توسيع واجهة مستخدم الإنشاء من خلال إجراءات الإنشاء لمعرفة التفاصيل.

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

مواصفات وظيفة المشغّل لإنشاء الصفحة الرئيسية للإضافة في مضيف Gmail. ويؤدي ذلك إلى إلغاء addOns.common.homepageTrigger.

إنشاء المشغّل

إعدادات إجراء الإنشاء. يُرجى الاطّلاع على توسيع واجهة مستخدم الإنشاء للحصول على مزيد من المعلومات.

تمثيل JSON
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
الحقول
draftAccess

string

تحدّد مستوى الوصول إلى البيانات المتاح لدالة بدء التشغيل. والخيارات الصالحة هي:

  • NONE، الإعداد التلقائي. ويؤدي ذلك إلى أن يكون كائن الحدث الذي تم تمريره إلى دالة مشغِّل الإنشاء فارغًا في الغالب.
  • METADATA، التي تعبِر عن كائن الحدث الذي يتم تمريره إلى دالة الإنشاء المُشغِّلة باستخدام قوائم مستلِمي الرسالة. يتطلب هذا الإعداد أن تتضمن الإضافة gmail.addons.current.message.metadata النطاق.
selectActions[]

object (SelectAction)

قائمة إجراءات الإنشاء التي تنشئ واجهات مستخدم للإنشاء، لكن هذه القائمة تقتصر على إجراء واحد لكل إضافة. يحتوي إجراء الإنشاء على رمز مقابل يظهر في نافذة الإنشاء في Gmail. تم تحديد الرمز من قِبل gmail.logoUrl.

مشغِّل المحتوى

ضبط العامل المشغِّل الذي يتم تنشيطه عندما يفتح المستخدم رسالة Gmail وعندما تستوفي الرسالة معايير معيّنة يمكنك الاطّلاع على توسيع واجهة مستخدم الرسالة للحصول على مزيد من المعلومات.

تمثيل JSON
{
  "onTriggerFunction": string,
  "unconditional": {},
}
الحقول
onTriggerFunction

string

هذه السمة مطلوبة لكل مشغِّل للمحتوى. اسم دالة "برمجة تطبيقات Google" التي يتم تنفيذها عند تنشيط المشغِّل.

راجِع دالة المشغِّل السياقي لمعرفة تفاصيل عن كيفية تحديد هذه الدالة.

unconditional

object

هذه السمة مطلوبة لكل مشغِّل للمحتوى. يُستخدم لتحديد أنه يتم تفعيل المشغِّل السياقي لجميع رسائل Gmail عند فتحها. وهذا هو الخيار الوحيد حاليًا، لذا يجب أن يكون هذا عنصرًا فارغًا دائمًا.

اختيار إجراء

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

تمثيل JSON
{
  "runFunction": string,
  "text": string
}
الحقول
runFunction

string

مطلوب لإنشاء الإجراءات. اسم دالة برمجة التطبيقات التي يتم تنفيذها عند اختيار إجراء الإنشاء هذا. تنشئ دالة الإنشاء هذه واجهة مستخدم الإنشاء الإضافية.

يُرجى الاطّلاع على دالة التشغيل لمعرفة التفاصيل.

text

string

مطلوب لإنشاء الإجراءات. تمثل هذه الخاصية وصفًا نصيًا قصيرًا لإجراء الإنشاء هذا.