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

إعدادات الموارد المستخدَمة لتحديد محتوى إضافة 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)
  },
  "meet": {
    object (Meet)
  }
}
الحقول
common

object (Common)

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

calendar

object (Calendar)

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

chat

object ()

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

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

drive

object (Drive)

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

gmail

object (Gmail)

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

docs

object (Docs)

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

sheets

object (Sheets)

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

slides

object (Slides)

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

meet

object (Meet)

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

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

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

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

object (HomepageTrigger)

الدالة التلقائية لتشغيل الإضافة homepage. يتم استخدام هذه المواصفات إذا لم يتم تحديد مشغّل خاص بالصفحة الرئيسية على مستوى المضيف. في حال عدم إدخال قيمة، يتم استخدام بطاقة عامة للصفحة الرئيسية.
layoutProperties

object (LayoutProperties)

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

string

مطلوبة تمثّل هذه السمة عنوان 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 أو سيشغّل دالة في برمجة تطبيقات.

تمثيل 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. اسم دالة برمجة تطبيقات التي يتم تنفيذها عند اختيارها

لمزيد من التفاصيل، راجِع دليل الإجراءات العامة.