إعدادات المورد المستخدَمة لتحديد محتوى إضافة Google Workspace وسلوكها ضمن المحرِّرين يجب أن تتضمّن ملفات بيان إضافات Google Workspace جميع المكوّنات التي تم وضع علامة مطلوبة عليها إذا كانت تضيف ميزات إلى "المحرِّر".
المحرّرون
إعدادات بيان إضافة Google Workspace ل إضافات المحرّر اطّلِع على مقالة توسيع نطاق أدوات التعديل باستخدام إضافات Google Workspace لمزيد من المعلومات.
تمثيل JSON |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "onFileScopeGrantedTrigger": { object (OnFileScopeGrantedTrigger) }, "linkPreviewTriggers": [ { object (LinkPreviewTriggers) } ], "createActionTriggers": [ { object (CreateActionTriggers) } } |
الحقول | |
---|---|
homepageTrigger |
تنشئ وظيفة التفعيل هذه
الصفحة الرئيسية للإضافة في
التطبيق المضيف، ما يؤدي إلى إلغاء
|
onFileScopeGrantedTrigger |
مطلوب إذا كانت الإضافة تتضمّن سلوكًا خاصًا بمستند Editor
الحالي، ويتم تفعيله عندما يوافق المستخدم على نطاق |
linkPreviewTriggers[] |
مطلوب لمعاينات الروابط قائمة بالعوامل المشغِّلة لميزة معاينة الروابط في ملف "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" لمعرفة التفاصيل، يُرجى الاطّلاع على معاينة الروابط باستخدام الشرائح الذكية. |
createActionTriggers[] |
مطلوبة لإنشاء مورد تابع لجهة خارجية قائمة بالعوامل المشغِّلة لإنشاء موارد في خدمة تابعة لجهة خارجية من قائمة @ لمعرفة التفاصيل، يُرجى الاطّلاع على إنشاء موارد تابعة لجهات خارجية باستخدام الشرائح الذكية. |
OnFileScopeGrantedTrigger
إعدادات لعامل تشغيل سياقي يتم تشغيله عند
طلب مربع حوار نطاق الملف باستخدام CardService.newEditorFileScopeActionResponseBuilder()
.requestFileScopeForActiveDocument().build();
ويمنح المستخدم إذن نطاق drive.file
.
تمثيل JSON |
---|
{ "runFunction": string } |
الحقول | |
---|---|
runFunction |
drive.file
في حال تحديدها، يجب تنفيذ هذه الدالة لإنشاء صفيف من عناصر
Card وعرضه في واجهة مستخدم الإضافة.
|
LinkPreviewTriggers
إعدادات عامل التشغيل الذي يتم تشغيله عندما يكتب المستخدم رابطًا أو يلصقه من خدمة تابعة لجهة خارجية أو غير تابعة لشركة Google في ملف "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google".
لإعداد هذا المشغِّل لإضافة Google Workspace، اطّلِع على معاينة الروابط باستخدام الشرائح الذكية.
تمثيل JSON |
---|
{ "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, "patterns": [ { object(patterns) } ] } |
الحقول | |
---|---|
labelText |
Example: Support case هذا النص ثابت ويتم عرضه قبل أن ينفّذ المستخدمون الإضافة.
|
localizedLabelText |
labelText للترجمة إلى لغات أخرى يجب تنسيق اللغة
بتنسيق ISO 639 والبلد أو المنطقة
بتنسيق ISO 3166،
مع الفصل بينهما بنقطتَي اتصال - . على سبيل المثال، en-US .
إذا كانت لغة المستخدم متوفّرة في مفاتيح الخريطة، سيرى المستخدم
النسخة المترجَمة من |
patterns[] |
|
runFunction |
https://www.googleapis.com/auth/workspace.linkpreview .
في حال تحديدها، يجب تنفيذ هذه الدالة لقبول عنصر حدث يحتوي على EDITOR_NAME.matchedUrl.url كوسيطة وعرض عنصر
Card واحد يعرض معاينة رابط في واجهة مستخدم الإضافة.
|
logoUrl |
logoUrl .
|
UriPattern
الإعدادات لكل نمط عنوان URL يؤدي إلى عرض معاينة الرابط
تمثيل JSON |
---|
{ "hostPattern": string, "pathPrefix" : string } |
الحقول | |
---|---|
hostPattern |
subdomain.example.com ، يجب تضمين النطاق الفرعي.
لمعاينة الروابط للنطاق بأكمله، حدِّد حرف بدل مع علامة النجمة (* ) كنطاق فرعي.
على سبيل المثال، يتطابق الرمز |
pathPrefix |
hostPattern
على سبيل المثال، إذا كان نمط مضيف عنوان URL هو لمطابقة جميع عناوين URL في نطاق نمط المضيف، اترك |
CreateActionTriggers
إعدادات مشغِّل يتم تنشيطها عندما يختار مستخدم عنصرًا من قائمة دمج تابع لجهة خارجية من قائمة Google Docs @.
لإعداد هذا المشغِّل لإضافة Google Workspace، اطّلِع على إنشاء موارد تابعة لجهات خارجية باستخدام الشرائح الذكية.
تمثيل JSON |
---|
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, } |
الحقول | |
---|---|
id |
[a-zA-Z0-9-]+. .
|
labelText |
Create support case
|
localizedLabelText |
labelText للترجمة إلى لغات أخرى يجب تنسيق اللغة
بتنسيق ISO 639 والبلد أو المنطقة
بتنسيق ISO 3166،
مع الفصل بينهما بنقطتَي اتصال - . على سبيل المثال، en-US .
إذا كانت لغة المستخدم متوفّرة في مفاتيح الخريطة، سيرى المستخدم
النسخة المترجَمة من |
runFunction |
|
logoUrl |
logoUrl .
|