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

يشير ذلك المصطلح إلى إعدادات الموارد التي يتم استخدامها لتحديد محتوى إضافة 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.