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

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

الإضافات

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

تمثيل JSON 
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "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".

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 التي يتم تنفيذها عندما يختار المستخدم هذا الإجراء، في حال توفّرها.

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