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

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

slides

object (Slides)

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

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