Package google.apps.script.type

الفهرس

• AddOnWidgetSet (رسالة)
• AddOnWidgetSet.WidgetType (تعداد)
• CommonAddOnManifest (رسالة)
• CreateActionExtensionPoint (رسالة)
• HomepageExtensionPoint (رسالة)
• HttpAuthorizationHeader (تعداد)
• HttpOptions (رسالة)
• LayoutProperties (رسالة)
• LinkPreviewExtensionPoint (رسالة)
• MenuItemExtensionPoint (رسالة)
• UniversalActionExtensionPoint (رسالة)
• UriPattern (رسالة)

AddOnWidgetSet

مجموعة التطبيقات المصغّرة الفرعية المستخدَمة في إحدى الإضافات

الحقول
usedWidgets[]	WidgetType قائمة التطبيقات المصغّرة المستخدَمة في إضافة

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	string مطلوب. الاسم المعروض للإضافة.
logoUrl	string مطلوب. عنوان URL لصورة الشعار المعروضة في شريط أدوات الإضافة.
layoutProperties	LayoutProperties خصائص التنسيق الشائعة للبطاقات الإضافية
addOnWidgetSet	AddOnWidgetSet التطبيقات المصغّرة المستخدَمة في الإضافة في حال عدم تحديد هذا الحقل، يتم استخدام المجموعة التلقائية.
useLocaleFromApp	bool ما إذا كان سيتم تمرير معلومات اللغة من التطبيق المضيف
homepageTrigger	HomepageExtensionPoint تُحدِّد نقطة نهاية سيتم تنفيذها في أي سياق، في أي مضيف. وستظلّ أيّ بطاقات يتم إنشاؤها بواسطة هذه الوظيفة متاحة للمستخدم في جميع الأوقات، ولكن قد يتم حجبها بواسطة المحتوى السياقي عندما تُعلن هذه الإضافة عن عوامل تشغيل أكثر استهدافًا.
universalActions[]	UniversalActionExtensionPoint تحدِّد هذه السمة قائمة بنقاط التوسيع في قائمة الإجراءات العامة التي تُستخدَم كقائمة إعدادات للإضافة. يمكن أن تكون نقطة الإضافة عنوان URL لرابط يتم فتحه أو نقطة نهاية يتم تنفيذها كإرسال نموذج.
openLinkUrlPrefixes	ListValue لا يمكن لإجراء OpenLink استخدام عنوان URL إلا باستخدام مخطّط HTTPS أو MAILTO أو TEL. بالنسبة إلى روابط HTTPS، يجب أيضًا أن يتطابق عنوان URL مع إحدى البادئات المحدّدة في القائمة المسموح بها. إذا حذفت البادئة المخطّط، يتم افتراض القيمة HTTPS. تتم إعادة كتابة روابط HTTP تلقائيًا إلى روابط HTTPS.

CreateActionExtensionPoint

إعداد عامل تشغيل يتم تشغيله عندما يستدعي مستخدم سير عمل إنشاء الموارد في أحد تطبيقات Google Workspace. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء موارد تابعة لجهات خارجية من قائمة "@".

الحقول
id	string مطلوب. المعرّف الفريد للتمييز بين نقاط الإضافة هذه. يمكن أن يتضمّن المعرّف 64 حرفًا كحدّ أقصى، ويجب أن يكون بالتنسيق [a-zA-Z0-9-]+.
labelText	string مطلوب. النص الذي يظهر بجانب رمز لنقطة دخول إنشاء المورد، مثل Create support case هذا النص ثابت ويتم عرضه قبل أن ينفّذ المستخدمون الإضافة.
localizedLabelText	map<string, string> اختيارية: خريطة labelText للترجمة إلى لغات أخرى أدخِل تنسيق اللغة بترميز ISO 639 والبلد أو المنطقة بترميز ISO 3166، مع الفصل بينهما بنقطتَي اتصال -. على سبيل المثال، en-US. إذا كانت لغة المستخدم متوفّرة في مفاتيح الخريطة، سيرى المستخدم النسخة المترجَمة من labelText.
runFunction	string مطلوب. نقطة نهاية لتنفيذها عند بدء سير عمل إنشاء مورد لإنشاء رابط.
logoUrl	string اختيارية: الرمز الذي يظهر لنقطة دخول إنشاء المرجع في حال حذف هذا الحقل، ستستخدم القائمة رمز شريط أدوات الإضافة logoUrl.

HomepageExtensionPoint

التنسيق الشائع لبيان عرض الصفحة الرئيسية للإضافات

الحقول
runFunction	string مطلوب. نقطة النهاية التي سيتم تنفيذها عند تفعيل نقطة الإضافة هذه.
enabled	BoolValue اختيارية: في حال ضبطه على false، يتم إيقاف عرض الصفحة الرئيسية في هذا السياق. يتم ضبط القيمة تلقائيًا على true في حال عدم ضبطها. إذا تم إيقاف عرض الصفحة الرئيسية المخصّص في إحدى الإضافات، يتم توفير بطاقة عامة تلخيصية للمستخدمين بدلاً من ذلك.

HttpAuthorizationHeader

عنوان التفويض الذي تم إرساله في طلبات HTTP الإضافية

عمليات التعداد
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED	القيمة التلقائية، ما يعادل SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN	أرسِل رمز تعريف لحساب خدمة النظام الخاص بحزمة إضافات Google Workspace الخاصة بالمشروع (الإعداد التلقائي).
USER_ID_TOKEN	أرسِل رمز تعريف للمستخدِم النهائي.
NONE	لا ترسِل عنوان مصادقة.

HttpOptions

خيارات لإرسال الطلبات إلى نقاط نهاية HTTP الإضافية

الحقول
authorizationHeader	HttpAuthorizationHeader إعداد رمز المرور المُرسَل في عنوان التفويض HTTP

LayoutProperties

سمات تنسيق البطاقة التي تتم مشاركتها في جميع تطبيقات مضيفة الإضافة

الحقول
primaryColor	string اللون الأساسي للإضافة لضبط لون شريط الأدوات في حال عدم ضبط لون أساسي، يتم استخدام القيمة التلقائية التي يوفّرها إطار العمل.
secondaryColor	string اللون الثانوي للإضافة يحدّد لون الأزرار. إذا تم ضبط اللون الأساسي ولكن لم يتم ضبط لون ثانوي، يكون اللون الثانوي هو نفسه اللون الأساسي. في حال عدم ضبط اللون الأساسي أو اللون الثانوي، يتم استخدام القيمة التلقائية التي يوفّرها إطار العمل.
useNewMaterialDesign	bool تفعيل تصميم البطاقات المتوافق مع لغة المواد

LinkPreviewExtensionPoint

إعدادات عامل التشغيل الذي يتم تشغيله عندما يكتب المستخدم رابطًا من خدمة تابعة لجهة خارجية أو غير تابعة لشركة Google أو يلصقه في ملف "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google".

الحقول
labelText	string مطلوب. نص مثال على شريحة ذكية تطلب من المستخدمين معاينة الرابط، مثل Example: Support case هذا النص ثابت ويتم عرضه قبل أن ينفّذ المستخدمون الإضافة.
localizedLabelText	map<string, string> اختيارية: خريطة labelText للترجمة إلى لغات أخرى يجب تنسيق اللغة بتنسيق ISO 639 والبلد أو المنطقة بتنسيق ISO 3166، مع الفصل بينهما بنقطتَي اتصال -. على سبيل المثال، en-US. إذا كانت لغة المستخدم متوفّرة في مفاتيح الخريطة، سيرى المستخدم النسخة المترجَمة من labelText.
patterns[]	UriPattern مطلوب. صفيف من أنماط عناوين URL التي تشغّل الإضافة لمعاينة الروابط
runFunction	string مطلوب. نقطة نهاية لتنفيذها عند بدء معاينة رابط.
logoUrl	string اختيارية: الرمز الذي يظهر في الشريحة الذكية وبطاقة المعاينة في حال حذف هذا الحقل، ستستخدم الإضافة رمز شريط الأدوات logoUrl.

MenuItemExtensionPoint

تنسيق شائع لتعريف عنصر قائمة أو زر يظهران داخل تطبيق مضيف

الحقول
runFunction	string مطلوب. نقطة النهاية التي سيتم تنفيذها عند تفعيل نقطة الإضافة هذه.
label	string مطلوب. نص مرئي للمستخدم يصف الإجراء الذي تم اتّخاذه من خلال تفعيل نقطة التوسيع هذه. على سبيل المثال، "إدراج فاتورة".
logoUrl	string عنوان URL لصورة الشعار المعروضة في شريط أدوات الإضافة. في حال عدم ضبطه، يتم ضبطه تلقائيًا على عنوان URL للشعار الأساسي للإضافة.

UniversalActionExtensionPoint

تنسيق لتعريف نقطة إضافة لعنصر قائمة إجراءات عامة

الحقول
label	string مطلوب. نص مرئي للمستخدم يصف الإجراء الذي تم اتّخاذه من خلال تفعيل نقطة الإضافة هذه، على سبيل المثال، "إضافة جهة اتصال جديدة".
حقل الربط action_type مطلوب. نوع الإجراء المتوافق مع عنصر قائمة الإجراءات الشاملة يمكن أن يكون رابطًا لفتح أو نقطة نهاية لتنفيذ. يمكن أن يكون action_type واحدًا فقط مما يلي:
openLink	string عنوان URL الذي سيتم فتحه بواسطة UniversalAction.
runFunction	string نقطة النهاية التي سيتم تنفيذها بواسطة UniversalAction.

UriPattern

الإعدادات لكل نمط عنوان URL يؤدي إلى عرض معاينة للرابط

الحقول
hostPattern	string مطلوبة لمعاينة كل نمط عنوان URL. نطاق نمط عنوان URL. تُعاين الإضافة الروابط التي تحتوي على هذا النطاق في عنوان URL. لمعاينة الروابط لنطاق فرعي محدّد، مثل subdomain.example.com، يجب تضمين النطاق الفرعي. لمعاينة الروابط للنطاق بأكمله، حدِّد حرف بدل مع علامة النجمة (*) كنطاق فرعي. على سبيل المثال، يتطابق *.example.com مع subdomain.example.com وanother.subdomain.example.com.
pathPrefix	string اختيارية: المسار الذي يُلحق نطاق hostPattern على سبيل المثال، إذا كان نمط مضيف عنوان URL هو support.example.com، لإقران عناوين URL للطلبات المستضافة على support.example.com/cases/، أدخِل cases. لمطابقة جميع عناوين URL في نطاق نمط المضيف، اترك pathPrefix فارغًا.