تشير هذه السمة إلى إعدادات المورد المستخدَمة لتحديد محتوى إضافة Google Workspace وسلوكها ضمن أدوات التحرير. يجب أن تتضمن بيانات إضافة Google Workspace جميع المكوّنات التي تم وضع علامة مطلوبة عليها إذا كانت تعمل على توسيع "محرّر إعلانات Google".
المحرِّرون
إعداد بيان إضافة 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 .
|