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

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

composeTrigger

object (ComposeTrigger)

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

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

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

مواصفات دالة التفعيل لإنشاء الصفحة الرئيسية في إضافة Chrome في مضيف 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

سمة مطلوبة لكلّ عامل تشغيل سياقي: اسم دالة برمجة التطبيقات التي يتم تنفيذها عند بدء تشغيل عامل التفعيل

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

unconditional

object

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

SelectAction

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

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

string

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

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

text

string

مطلوبة لإجراءات الإنشاء وصف نصي موجز لهذا الإجراء المركب