مورد بيان 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 Workspace.

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

composeTrigger

object (ComposeTrigger)

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

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

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

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

ComposeTrigger

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

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

string

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

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

object (SelectAction)

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

ContextualTrigger

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

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

string

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

اطّلِع على وظيفة المشغِّل السياقي للحصول على تفاصيل حول كيفية تعريف هذه الوظيفة.

unconditional

object

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

SelectAction

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

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

string

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

اطّلِع على وظيفة مشغّل الإنشاء للحصول على التفاصيل.

text

string

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