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

إعدادات الموارد المستخدَمة لتحديد محتوى إضافة 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)

هذه السمة مطلوبة إذا كانت الإضافة تتضمّن سلوكًا خاصًا بمستند "المحرّر" الحالي، ويتم تفعيلها عندما يمنح المستخدم الإذن لنطاق 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، لاستخدام عناوين URL للحالات المستضافة على support.example.com/cases/، استخدِم cases.

لمطابقة جميع عناوين URL في نطاق نمط المضيف، اترك pathPrefix فارغًا.

CreateActionTriggers

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

لإعداد هذا المشغّل لإضافة 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.