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

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

تكون الإضافة مطلوبة إذا كانت إضافتك تتضمّن سلوكًا خاصًا بمستند "محرّر إعلانات Google" الحالي، ويتم تشغيله عندما يفوّض المستخدم نطاق 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.