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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يجب أن يتضمّن إعداد الموارد المستخدَم لتحديد 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 للصورة المعروضة في شريط الأدوات.

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

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