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، أدخِل cases لمطابقة عناوين URL للحالات التي يستضيفها support.example.com/cases/. لمطابقة جميع عناوين URL في نطاق نمط المضيف، اترك pathPrefix فارغًا.