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

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

الإضافات

المستوى الأعلى من ضبط ملف بيان إضافة 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.

يمكنك الاطّلاع على الوصول إلى لغة المستخدم والمناطق الزمنية لمزيد من التفاصيل.

خصائص التخطيط

عملية إعداد تتحكّم في Google Workspace شريط أدوات الإضافة وألوان الأزرار ومظهرها.

تمثيل JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
الحقول
primaryColor

string

لون شريط الأدوات الإعداد التلقائي هو اللون الرمادي (#424242).
secondaryColor

string

اللون التلقائي للأزرار. الإعداد التلقائي هو اللون الأساسي (إذا تم ضبطه)، وبخلاف ذلك، يكون الإعداد التلقائي هو الأزرق (#2196F3).

الإجراءات الشاملة

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

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