الفهرس
AddOnWidgetSet
(رسالة)AddOnWidgetSet.WidgetType
(تعداد)CommonAddOnManifest
(رسالة)CreateActionExtensionPoint
(رسالة)HomepageExtensionPoint
(رسالة)HttpAuthorizationHeader
(تعداد)HttpOptions
(رسالة)LayoutProperties
(رسالة)LinkPreviewExtensionPoint
(رسالة)MenuItemExtensionPoint
(رسالة)UniversalActionExtensionPoint
(رسالة)UriPattern
(رسالة)
AddOnWidgetSet
المجموعة الفرعية للتطبيق المصغّر التي تستخدمها إحدى الإضافات.
الحقول | |
---|---|
usedWidgets[] |
قائمة التطبيقات المصغّرة المستخدمة في إحدى الإضافات |
WidgetType
نوع التطبيق المصغّر WIDGET_TYPE_UNSPECIFIED
هي مجموعة التطبيقات المصغّرة الأساسية.
عمليات التعداد | |
---|---|
WIDGET_TYPE_UNSPECIFIED |
تم ضبط التطبيق المصغّر التلقائي. |
DATE_PICKER |
أداة اختيار التاريخ |
STYLED_BUTTONS |
تشمل الأزرار ذات الأنماط المختلفة أزرارًا معبأة وأزرارًا غير مفعّلة. |
PERSISTENT_FORMS |
تتيح النماذج الثابتة الاحتفاظ بقيم النموذج أثناء الإجراءات. |
FIXED_FOOTER |
تذييل ثابت في البطاقة |
UPDATE_SUBJECT_AND_RECIPIENTS |
تعديل موضوع المسودة ومستلميها |
GRID_WIDGET |
التطبيق المصغّر للشبكة |
ADDON_COMPOSE_UI_ACTION |
إجراء إضافة Gmail ينطبق على واجهة مستخدم إنشاء الإضافة. |
CommonAddOnManifest
إعدادات الإضافة التي تتم مشاركتها بين جميع تطبيقات المضيف للإضافة
الحقول | |
---|---|
name |
مطلوبة. الاسم المعروض للإضافة |
logoUrl |
مطلوبة. عنوان URL لصورة الشعار التي تظهر في شريط أدوات الإضافات. |
layoutProperties |
خصائص التنسيق الشائعة للبطاقات الإضافية |
addOnWidgetSet |
التطبيقات المصغّرة المستخدمة في الإضافة وإذا لم يتم تحديد هذا الحقل، سيتم استخدام المجموعة التلقائية. |
useLocaleFromApp |
ما إذا كان سيتم تمرير معلومات اللغة من التطبيق المضيف. |
homepageTrigger |
تحدد نقطة النهاية التي سيتم تنفيذها في أي سياق، في أي مضيف. ستكون أي بطاقات تُنشئها هذه الوظيفة متاحة للمستخدم دائمًا، ولكن قد يحجبها المحتوى السياقي عندما تعلن هذه الإضافة عن عوامل تشغيل أكثر استهدافًا. |
universalActions[] |
تحدِّد هذه السياسة قائمة بنقاط الإضافات في قائمة الإجراءات العامة، والتي تعمل كقائمة إعدادات للإضافة. يمكن أن تكون نقطة الإضافة عنوان URL لرابط يمكن فتحه أو نقطة نهاية لتنفيذها أثناء إرسال نموذج. |
openLinkUrlPrefixes |
يمكن لإجراء OpenLink أن يستخدم فقط عنوان URL يحتوي على مخطَّط |
CreateActionExtensionPoint
إعدادات المشغِّل الذي يتم تنشيطه عندما يستدعي المستخدم سير عمل إنشاء الموارد في تطبيق Google Workspace. للمزيد من المعلومات، يُرجى الاطّلاع على إنشاء موارد خارجية من قائمة @.
الحقول | |
---|---|
id |
مطلوبة. المعرّف الفريد للتمييز بين نقطة الإضافة هذه. يمكن أن يصل طول المعرّف إلى 64 حرفًا، ويجب أن يكون بتنسيق |
labelText |
مطلوبة. النص الذي يتم عرضه بجانب رمز لنقطة إدخال إنشاء الموارد، مثل |
localizedLabelText |
اختياريّ. خريطة في حال توفّر لغة المستخدم في مفاتيح الخريطة، سيظهر للمستخدم النسخة المترجَمة من |
runFunction |
مطلوبة. نقطة نهاية يتم تنفيذها عند بدء سير عمل إنشاء الموارد لإنشاء رابط. |
logoUrl |
اختياريّ. الرمز الذي يظهر لنقطة دخول إنشاء المورد. وفي حال حذفها، ستستخدم القائمة رمز شريط أدوات الإضافة |
HomepageExtensionPoint
التنسيق الشائع للإعلان عن عرض الصفحة الرئيسية للإضافة.
الحقول | |
---|---|
runFunction |
مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه. |
enabled |
اختياريّ. وفي حال ضبط السياسة على وتكون القيمة التلقائية في حال إيقاف عرض الصفحة الرئيسية المخصَّصة لإحدى الإضافات، يتم تقديم بطاقة نظرة عامة عامة للمستخدمين بدلاً من ذلك. |
HttpAuthorizationHeader
تم إرسال رأس التفويض في طلبات الإضافة "HTTP
".
عمليات التعداد | |
---|---|
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED |
القيمة التلقائية، تعادل SYSTEM_ID_TOKEN . |
SYSTEM_ID_TOKEN |
يمكنك إرسال رمز مميز لرقم التعريف لحساب خدمة النظام لإضافة Google Workspace الخاصة بالمشروع (تلقائيًا). |
USER_ID_TOKEN |
أرسِل الرمز المميز للمعرّف الخاص بالمستخدم النهائي. |
NONE |
لا ترسِل عنوان مصادقة. |
HttpOptions
خيارات إرسال الطلبات إلى نقاط نهاية HTTP
الإضافية
الحقول | |
---|---|
authorizationHeader |
إعدادات الرمز المميّز الذي تم إرساله في عنوان تفويض |
LayoutProperties
تتم مشاركة خصائص تنسيق البطاقة بين جميع تطبيقات المضيف الإضافية.
الحقول | |
---|---|
primaryColor |
اللون الأساسي للإضافة. يضبط لون شريط الأدوات. في حال عدم ضبط لون أساسي، يتم استخدام القيمة التلقائية التي يوفّرها إطار العمل. |
secondaryColor |
اللون الثانوي للإضافة. يضبط لون الأزرار. في حال ضبط اللون الأساسي بدون ضبط لون ثانوي، يكون اللون الثانوي هو نفسه اللون الأساسي. في حال عدم ضبط لون أساسي أو لون ثانوي، يتم استخدام القيمة التلقائية التي يوفّرها إطار العمل. |
useNewMaterialDesign |
تفعيل التصميم متعدد الأبعاد للبطاقات |
LinkPreviewExtensionPoint
إعداد مشغِّل يتم تنشيطه عندما يكتب المستخدم رابطًا أو يلصقه من خدمة تابعة لجهة خارجية أو خدمة غير تابعة لـ Google في ملف "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google".
الحقول | |
---|---|
labelText |
مطلوبة. نص مثال لشريحة ذكية يطلب من المستخدمين معاينة الرابط، مثل |
localizedLabelText |
اختياريّ. خريطة في حال توفّر لغة المستخدم في مفاتيح الخريطة، سيظهر للمستخدم النسخة المترجَمة من |
patterns[] |
مطلوبة. مصفوفة من أنماط عناوين URL التي تؤدي إلى تشغيل الإضافة الخاصة بمعاينة الروابط. |
runFunction |
مطلوبة. نقطة نهاية المطلوب تنفيذها عند تشغيل معاينة الرابط. |
logoUrl |
اختياريّ. الرمز الذي يظهر في الشريحة الذكية وبطاقة المعاينة في حال حذفها، ستستخدم الإضافة رمز شريط الأدوات الخاص بها، |
MenuItemExtensionPoint
تنسيق شائع للإعلان عن عنصر قائمة أو زر يظهر داخل تطبيق مضيف.
الحقول | |
---|---|
runFunction |
مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه. |
label |
مطلوبة. نص مرئي للمستخدم يصف الإجراء الذي تم اتخاذه من خلال تفعيل نقطة الإضافة هذه. على سبيل المثال، "إدراج فاتورة". |
logoUrl |
عنوان URL لصورة الشعار التي تظهر في شريط أدوات الإضافات. وفي حال عدم ضبط هذه السياسة، سيتم ضبطها تلقائيًا على عنوان URL للشعار الأساسي للإضافة. |
UniversalActionExtensionPoint
تنسيق للإعلان عن نقطة إضافة عنصر قائمة إجراءات عامة.
الحقول | |
---|---|
label |
مطلوبة. نص يظهر للمستخدم يصف الإجراء الذي تم اتخاذه من خلال تفعيل نقطة الإضافة هذه، مثل "إضافة جهة اتصال جديدة". |
حقل الاتحاد action_type مطلوبة. نوع الإجراء المتاح في عنصر قائمة إجراء عام. ويمكن أن يكون رابطًا لفتحه أو نقطة نهاية للتنفيذ. يمكن أن يكون الحقل "action_type " واحدًا فقط مما يلي: |
|
openLink |
عنوان URL الذي سيتم فتحه بواسطة UniversalAction. |
runFunction |
نقطة نهاية سيتم تشغيلها من خلال UniversalAction. |
UriPattern
هي إعدادات كل نمط عنوان URL يؤدي إلى معاينة الرابط.
الحقول | |
---|---|
hostPattern |
مطلوب لكل نمط عنوان URL للمعاينة. تمثّل هذه السمة نطاق نمط عنوان URL. روابط معاينات الإضافة التي تحتوي على هذا النطاق في عنوان URL. لمعاينة الروابط لنطاق فرعي معيّن، مثل على سبيل المثال، تتطابق السمة |
pathPrefix |
اختياريّ. تمثّل هذه السمة المسار الذي يلحق نطاق على سبيل المثال، إذا كان نمط مضيف عنوان URL هو لمطابقة جميع عناوين URL في نطاق نمط المضيف، اترك |