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

تمّت إزالة هذا العمود. اسم دالة برمجة تطبيقات تُجري عمليات التحقّق من تفويض الجهات الخارجية.

تم إيقاف هذه الدالة نهائيًا. بدلاً من ذلك، يجب أن تعرض الإضافة استثناءً من الاستدعاء الرئيسي، كما هو موضّح في مثال إعداد 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

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

string

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