مورد بيان المحرِّر

إعدادات المورد المستخدَمة لتحديد محتوى إضافة Google Workspace وسلوكها ضمن المحرِّرين يجب أن تتضمّن ملفات بيان إضافات Google Workspace جميع المكوّنات التي تم وضع علامة مطلوبة عليها إذا كانت تضيف ميزات إلى "المحرِّر".

المحرّرون

إعدادات بيان إضافة Google Workspace ل إضافات المحرّر اطّلِع على مقالة توسيع نطاق أدوات التعديل باستخدام إضافات Google Workspace لمزيد من المعلومات.

تمثيل JSON
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
الحقول
homepageTrigger

object (HomepageTrigger)

تنشئ وظيفة التفعيل هذه الصفحة الرئيسية للإضافة في التطبيق المضيف، ما يؤدي إلى إلغاء addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

مطلوب إذا كانت الإضافة تتضمّن سلوكًا خاصًا بمستند Editor الحالي، ويتم تفعيله عندما يوافق المستخدم على نطاق drive.file .

linkPreviewTriggers[]

object (LinkPreviewTriggers)

مطلوب لمعاينات الروابط قائمة بالعوامل المشغِّلة لميزة معاينة الروابط في ملف "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" لمعرفة التفاصيل، يُرجى الاطّلاع على معاينة الروابط باستخدام الشرائح الذكية.

createActionTriggers[]

object (createActionTriggers)

مطلوبة لإنشاء مورد تابع لجهة خارجية قائمة بالعوامل المشغِّلة لإنشاء موارد في خدمة تابعة لجهة خارجية من قائمة @ لمعرفة التفاصيل، يُرجى الاطّلاع على إنشاء موارد تابعة لجهات خارجية باستخدام الشرائح الذكية.

OnFileScopeGrantedTrigger

إعدادات لعامل تشغيل سياقي يتم تشغيله عند طلب مربع حوار نطاق الملف باستخدام CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); ويمنح المستخدم إذن نطاق drive.file.

تمثيل JSON
{
  "runFunction": string
}
الحقول
runFunction

string

اسم الدالة التي سيتم تنفيذها إذا تم منح نطاق drive.file في حال تحديدها، يجب تنفيذ هذه الدالة لإنشاء صفيف من عناصر Card وعرضه في واجهة مستخدم الإضافة.

LinkPreviewTriggers

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

لإعداد هذا المشغِّل لإضافة Google Workspace، اطّلِع على معاينة الروابط باستخدام الشرائح الذكية.

تمثيل JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
الحقول
labelText

string

مطلوبة نص مثال على شريحة ذكية تطلب من المستخدمين معاينة الرابط، مثل Example: Support case هذا النص ثابت ويتم عرضه قبل أن ينفّذ المستخدمون الإضافة.
localizedLabelText

map (key: string, value: string)

اختيارية: خريطة labelText للترجمة إلى لغات أخرى يجب تنسيق اللغة بتنسيق ISO 639 والبلد أو المنطقة بتنسيق ISO 3166، مع الفصل بينهما بنقطتَي اتصال -. على سبيل المثال، en-US.

إذا كانت لغة المستخدم متوفّرة في مفاتيح الخريطة، سيرى المستخدم النسخة المترجَمة من labelText.

patterns[]

object (UriPattern)

مطلوبة صفيف من أنماط عناوين URL التي تشغّل الإضافة لمعاينة الروابط
runFunction

string

مطلوبة اسم الدالة التي سيتم تنفيذها عندما يفوّض المستخدم نطاق https://www.googleapis.com/auth/workspace.linkpreview. في حال تحديدها، يجب تنفيذ هذه الدالة لقبول عنصر حدث يحتوي على EDITOR_NAME.matchedUrl.url كوسيطة وعرض عنصر Card واحد يعرض معاينة رابط في واجهة مستخدم الإضافة.
logoUrl

string

اختيارية: الرمز الذي يظهر في الشريحة الذكية وبطاقة المعاينة في حال حذفه، ستستخدم الإضافة رمز شريط الأدوات logoUrl.

UriPattern

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

تمثيل JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
الحقول
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 فارغًا.

CreateActionTriggers

إعدادات مشغِّل يتم تنشيطها عندما يختار مستخدم عنصرًا من قائمة دمج تابع لجهة خارجية من قائمة Google Docs @.

لإعداد هذا المشغِّل لإضافة Google Workspace، اطّلِع على إنشاء موارد تابعة لجهات خارجية باستخدام الشرائح الذكية.

تمثيل JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
الحقول
id

string

مطلوبة المعرّف الفريد للتمييز بين نقطة الإضافة هذه. يمكن أن يتألّف المعرّف من 64 حرفًا كحدّ أقصى، ويجب أن يكون بالتنسيق التالي: [a-zA-Z0-9-]+..
labelText

string

مطلوبة النص الذي يظهر في قائمة @ ، مثل Create support case
localizedLabelText

map (key: string, value: string)

اختيارية: خريطة labelText للترجمة إلى لغات أخرى يجب تنسيق اللغة بتنسيق ISO 639 والبلد أو المنطقة بتنسيق ISO 3166، مع الفصل بينهما بنقطتَي اتصال -. على سبيل المثال، en-US.

إذا كانت لغة المستخدم متوفّرة في مفاتيح الخريطة، سيرى المستخدم النسخة المترجَمة من labelText.

runFunction

string

مطلوبة اسم الدالة التي سيتم تنفيذها عندما يختار مستخدم نقطة إضافة من قائمة @. من المفترض أن تعرِض الدالة بطاقة نموذج تتضمّن مدخلات لإنشاء المرجع التابع لجهة خارجية.
logoUrl

string

اختيارية: الرمز الذي يظهر في قائمة @ في حال حذفه، ستستخدم الإضافة رمز شريط الأدوات logoUrl.