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

إعدادات الموارد المستخدَمة لتحديد محتوى إضافة 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 توسّع نطاق استخدام "جداول بيانات Google". إعدادات المظهر والسلوك ضمن تطبيق Sheets المضيف في حال عدم توفّرها، سيتم إيقاف الإضافة في "جداول بيانات 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. اسم دالة برمجة تطبيقات التي يتم تنفيذها عند اختيارها

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