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

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

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

composeTrigger

object (ComposeTrigger)

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

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

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

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

ComposeTrigger

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

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

string

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

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

object (SelectAction)

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

ContextualTrigger

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

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

string

مطلوبة لكل مشغّل سياقي اسم دالة Apps Script التي يتم تنفيذها عند تشغيل المشغّل.

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

unconditional

object

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

SelectAction

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

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

string

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

راجِع دالة مشغّل الإنشاء للاطّلاع على التفاصيل.

text

string

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