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

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

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

عرض دالة التشغيل السياقية للحصول على تفاصيل حول كيفية تعريف ذلك الأخرى.

unconditional

object

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

SelectAction

تهيئة إجراء الإنشاء التي تحدد الدالة التي سيتم تشغيلها عند تحديد المستخدم إجراء الإنشاء.

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

string

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

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

text

string

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