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

تهيئة المورد المستخدمة لتحديد إضافة 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)

يجب ملء هذا الحقل. تحدد قيم a إضافة 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".

sheets

object (Sheets)

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

اللون الافتراضي للأزرار. القيم التلقائية على اللون الأساسي (إذا كان set); يتم ضبطه تلقائيًا على اللون الأزرق (#2196F3).

UniversalAction

إعداد إجراء عام. عند تحديده، يؤدي إجراء عام إما إلى فتح رابط عنوان URL المحدّد أو تشغيله دالة برمجة التطبيقات المحددة.

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

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