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

إعدادات الموارد المستخدَمة لتحديد محتوى إضافة 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 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، مع الفصل بينهما بشرطة -.
patterns[]

object (UriPattern)

مطلوبة. مجموعة من أنماط عناوين URL التي تؤدي إلى تفعيل معاينة الروابط في الإضافة
runFunction

string

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

string

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

UriPattern

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

تمثيل JSON
{
  "hostPattern": string,
  "pathPrefix" : string
}
الحقول
hostPattern

string

مطلوبة لكل نمط عنوان URL تمثّل هذه السمة نطاق نمط عنوان URL. تعرض الإضافة معاينات للروابط التي تتضمّن هذا النطاق. لمطابقة جميع النطاقات الفرعية، استخدِم علامة النجمة كحرف بدل (*).
pathPrefix

string

اختياريّ. المسار الذي يلحق بالنطاق لمطابقة جميع عناوين 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، مع الفصل بينهما بشرطة -.
runFunction

string

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

string

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