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

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

chat

object ()

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

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

object (Drive)

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

slides

object (Slides)

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

meet

object object (Meet)

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

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

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

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

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