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

يشير ذلك المصطلح إلى إعدادات المورد المستخدمة لتحديد محتوى إضافة 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" التي يتم تنفيذها عندما يختار المستخدم هذا الإجراء، في حال توفّره.

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