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

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

AddOns

يشير إلى المستوى الأعلى لإعداد بيان "إضافة 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 المحدّد أو تشغيل دالة "برمجة تطبيقات Google" المحدّدة.

تمثيل 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. في حال توفُّر اسم وظيفة "برمجة تطبيقات Google" التي يتم تنفيذها عندما يختار المستخدم هذا الإجراء.

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