مورد بيان 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. عند تنشيط المشغِّل، يتم تنفيذ وظيفة "برمجة تطبيقات Google" محدّدة، وعادةً ما يتم إنشاء بطاقات جديدة وتعديل واجهة المستخدم.
homepageTrigger

object (HomepageTrigger)

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

ComposeTrigger

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

تمثيل 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

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