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

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

المحرِّرون

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