إعدادات المورد المستخدَمة لتحديد محتوى إضافة Google Workspace وسلوكها ضمن أدوات التحرير. يجب أن تتضمّن بيانات "إضافة Google Workspace" جميع المكونات التي تم وضع علامة مطلوب عليها في حال توسيع "المحرّر".
المحرّرون
ضبط بيان "إضافة Google Workspace" لإضافات المحرِّرين يُرجى الاطّلاع على توسيع نطاق "المحرِّرين" باستخدام إضافات Google Workspace للحصول على مزيد من المعلومات.
تمثيل JSON |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "onFileScopeGrantedTrigger": { object (OnFileScopeGrantedTrigger) }, "linkPreviewTriggers": [ { object (LinkPreviewTriggers) } ], "createActionTriggers": [ { object (CreateActionTriggers) } } |
الحقول | |
---|---|
homepageTrigger |
تنشئ دالة التشغيل هذه الصفحة الرئيسية للإضافة في
تطبيق المضيف. ويؤدي ذلك إلى إلغاء
|
onFileScopeGrantedTrigger |
تكون الإضافة مطلوبة إذا كانت إضافتك تتضمّن سلوكًا خاصًا بمستند "محرّر إعلانات Google" الحالي، ويتم تشغيله عندما يفوّض المستخدم نطاق |
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".
لإعداد هذا المشغِّل لإضافة 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 .
|