مورد بيان الإضافات

إعدادات المورد المستخدَمة لتحديد محتوى وسلوك إضافة Google Workspace يجب أن تحتوي ملفات بيان إضافات Google Workspace على جميع المكوّنات التي تم وضع علامة عليها على أنّها مطلوبة.

AddOns

المستوى الأعلى من ملف بيان إضافة Google Workspace الإعدادات

تمثيل JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "chat": {
    object (Chat)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
الحقول
common

object (Common)

مطلوبة تحدِّد قيمًا لإضافة Google Workspace تكون مشتركة لكل تطبيق مضيف. يتم استخدام بعض القيم المحدّدة هنا كقيمة تلقائية عند حذف قيم محدّدة لمضيف معيّن.

calendar

object (Calendar)

مطلوبة إذا كانت إضافة Google Workspace توفّر ميزات إضافية في "تقويم Google". إعدادات مظهر إضافة Google Workspace وسلوكها ضمن تطبيق مضيف "تقويم Google" في حال حذف هذا الحقل، يتم إيقاف الإضافة في "تقويم Google".

chat

object ()

مطلوب إذا كانت إضافة Google Workspace توفّر ميزات إضافية في Chat. إعدادات تطبيق Google Chat. في حال حذف هذا الحقل، يتم إيقاف الإضافة في Google Chat.

يجب أن يكون عنصر addOns.chat فارغًا. لضبط سلوك الإضافة ومظهرها في Chat، اطّلِع على مقالة ضبط تطبيق Chat.

drive

object (Drive)

مطلوب إذا كانت إضافة Google Workspace توفّر ميزات إضافية في Google Drive. إعدادات مظهر إضافة Google Workspace وسلوكها ضمن تطبيق مضيف Google Drive في حال حذف هذا الحقل، يتم إيقاف الإضافة في Google Drive.

gmail

object (Gmail)

مطلوب إذا كانت إضافة Google Workspace توفّر ميزات إضافية في Gmail. إعدادات مظهر إضافة Google Workspace وسلوكها ضمن تطبيق مضيف Gmail في حال حذف هذا الحقل، يتم إيقاف الإضافة في Gmail.

docs

object (Docs)

مطلوب إذا كانت إضافة Google Workspace توفّر ميزات إضافية في "مستندات Google". إعدادات مظهر إضافة Google Workspace وسلوكها ضمن تطبيق مضيف "مستندات Google" في حال حذف هذا الحقل، يتم إيقاف الإضافة في "مستندات Google".

sheets

object (Sheets)

مطلوب إذا كانت إضافة Google Workspace توفّر ميزات إضافية في "جداول بيانات Google". إعدادات مظهر إضافة Google Workspace وسلوكها ضمن تطبيق مضيف "جداول بيانات Google" في حال حذف هذا الحقل، يتم إيقاف الإضافة في "جداول بيانات Google".

slides

object (Slides)

مطلوب إذا كانت إضافة Google Workspace توفّر ميزات إضافية في "العروض التقديمية من Google". إعدادات مظهر إضافة Google Workspace وسلوكها ضمن تطبيق مضيف "العروض التقديمية من Google" في حال حذف هذا الحقل، يتم إيقاف الإضافة في "العروض التقديمية من Google".

الإعدادات الشائعة

إعدادات البيان للمَعلمات الشائعة في كل تطبيق مضيف يتم استخدام بعض القيم المحدّدة هنا كقيمة تلقائية عند حذف قيم معيّنة لمضيف معيّن.

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
الحقول
homepageTrigger

object (HomepageTrigger)

مواصفات وظيفة المشغِّل التلقائية لإنشاء الصفحة الرئيسية للإضافة. يتم استخدام هذه المواصفة في حال عدم تحديد عامل تشغيل الصفحة الرئيسية الخاص بالمضيف. وفي حال حذف هذا الحقل أيضًا، يتم إنشاء بطاقة عامة للصفحة الرئيسية واستخدامها عند الحاجة.
layoutProperties

object (LayoutProperties)

إعدادات للألوان المستخدَمة في شريط أدوات الإضافة والأزرار
logoUrl

string

مطلوبة عنوان URL للصورة المعروضة في شريط الأدوات يجب أن يكون عنوان URL متاحًا للجميع.

name

string

مطلوبة اسم الإضافة المعروض في شريط الأدوات

openLinkUrlPrefixes[]

string

مطلوبة إذا كانت الإضافة تعرض أي روابط خارجية، سواء كانت ضمن التطبيقات المصغّرة التي تستخدم OpenLink أو التطبيقات المصغّرة النصية التي تستخدم علامات علامات الربط HTML. قائمة بادئات عناوين URL التي تستخدم HTTPS لحماية بيانات المستخدمين، يجب أن يتطابق أي رابط تعرِضه الإضافة مع إحدى البادئات الواردة في هذه القائمة.

اطّلِع على عناوين URL المدرَجة في القائمة المسموح بها للحصول على مزيد من التفاصيل.

universalActions[]

object (UniversalAction)

قائمة بالإجراءات العامة المتوفّرة دائمًا في واجهة مستخدم الإضافة
useLocaleFromApp

boolean

إذا كان true، يجب أن تتضمّن عناصر أحداث المُرسَلة إلى دوالّ الاستدعاء للإجراءات أو دوالّ التفعيل معلومات لغة المستخدم والمنطقة الزمنية. الإعداد التلقائي هو false.

اطّلِع على الوصول إلى لغة المستخدم ومناطق الزمن للحصول على مزيد من التفاصيل.

LayoutProperties

إعداد يتحكّم في Google Workspace ألوان شريط أدوات الإضافة وألوان الأزرار ومظهرها

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

string

لون شريط الأدوات الإعداد التلقائي هو الرمادي (#424242).
secondaryColor

string

اللون التلقائي للأزرار يتم ضبطه تلقائيًا على اللون الأساسي (إذا كان قد تم ضبطه)، وإلا يتم ضبطه تلقائيًا على الأزرق (#2196F3).

UniversalAction

إعداد لإجراء عام عند اختيار إجراء عام، إما أن يفتح رابط عنوان URL المحدّد أو يشغّل دالة Apps Script المحدّدة.

تمثيل JSON
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
الحقول
label

string

مطلوبة لكل إجراء عام: النص المعروض في واجهة المستخدِم قائمة هذا الإجراء
runFunction

string

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

اطّلِع على دليل الإجراءات العامة للاطّلاع على التفاصيل.