مورد بيان 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" تنفّذ عمليات التحقّق من التفويضات التابعة لجهات خارجية

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

composeTrigger

object (ComposeTrigger)

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

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

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

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

ComposeTrigger

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

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

string

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

  • ‫NONE (القيمة التلقائية): يكون عنصر الحدث فارغًا في الغالب.
  • METADATA: يتضمّن عنصر الحدث قوائم المستلمين. يتطلّب ذلك نطاق gmail.addons.current.message.metadata scope.
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

مطلوب لإجراءات الإنشاء. وصف موجز للإجراء