REST Resource: projects.deployments

المورد: النشر

نشر إضافة Google Workspace

تمثيل JSON
{
  "name": string,
  "oauthScopes": [
    string
  ],
  "addOns": {
    object (AddOns)
  },
  "etag": string
}
الحقول
name

string

اسم مورد النشر مثال: projects/123/deployments/my_deployment

oauthScopes[]

string

قائمة نطاقات Google OAuth التي يجب طلب الموافقة من المستخدم النهائي عليها قبل تنفيذ نقطة نهاية الإضافة.

addOns

object (AddOns)

إعدادات إضافة Google Workspace

etag

string

يحسب الخادم هذه القيمة استنادًا إلى إصدار النشر في مساحة التخزين، وقد يتم إرسالها عند طلبات التحديث والحذف للتأكد من امتلاك العميل لقيمة حديثة قبل المتابعة.

AddOns

إعدادات إضافة Google Workspace

تمثيل JSON
{
  "common": {
    object (CommonAddOnManifest)
  },
  "gmail": {
    object (GmailAddOnManifest)
  },
  "drive": {
    object (DriveAddOnManifest)
  },
  "calendar": {
    object (CalendarAddOnManifest)
  },
  "docs": {
    object (DocsAddOnManifest)
  },
  "sheets": {
    object (SheetsAddOnManifest)
  },
  "slides": {
    object (SlidesAddOnManifest)
  },
  "httpOptions": {
    object (HttpOptions)
  }
}
الحقول
common

object (CommonAddOnManifest)

الإعدادات الشائعة في جميع إضافات Google Workspace

gmail

object (GmailAddOnManifest)

ضبط إضافة Gmail

drive

object (DriveAddOnManifest)

ضبط إضافة Drive

calendar

object (CalendarAddOnManifest)

ضبط إضافة "تقويم Google"

docs

object (DocsAddOnManifest)

ضبط إضافة "مستندات Google"

sheets

object (SheetsAddOnManifest)

ضبط الإضافة الخاصة ببرنامج "جداول بيانات Google"

slides

object (SlidesAddOnManifest)

ضبط إضافة "العروض التقديمية من Google"

httpOptions

object (HttpOptions)

خيارات إرسال الطلبات إلى نقاط نهاية HTTP الإضافية

CommonAddOnManifest

إعدادات الإضافة التي تتم مشاركتها عبر جميع تطبيقات مضيف الإضافة

تمثيل JSON
{
  "name": string,
  "logoUrl": string,
  "layoutProperties": {
    object (LayoutProperties)
  },
  "addOnWidgetSet": {
    object (AddOnWidgetSet)
  },
  "useLocaleFromApp": boolean,
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "universalActions": [
    {
      object (UniversalActionExtensionPoint)
    }
  ],
  "openLinkUrlPrefixes": array
}
الحقول
name

string

مطلوبة. الاسم المعروض للإضافة

logoUrl

string

مطلوبة. عنوان URL لصورة الشعار المعروضة في شريط أدوات الإضافة

layoutProperties

object (LayoutProperties)

خصائص التنسيق الشائعة للبطاقات الإضافية

addOnWidgetSet

object (AddOnWidgetSet)

التطبيقات المصغّرة المستخدَمة في الإضافة إذا لم يتم تحديد هذا الحقل، يتم استخدام المجموعة التلقائية.

useLocaleFromApp

boolean

يمكنك اختيار ما إذا كان سيتم تمرير معلومات اللغة من تطبيق المضيف.

homepageTrigger

object (HomepageExtensionPoint)

تحدد نقطة نهاية سيتم تنفيذها في أي سياق، في أي مضيف. ستكون أي بطاقات يتم إنشاؤها من خلال هذه الوظيفة متاحة للمستخدم دائمًا، ولكن قد يحجبها المحتوى السياقي عندما تعرض هذه الإضافة عوامل تشغيل أكثر استهدافًا.

universalActions[]

object (UniversalActionExtensionPoint)

تحدد هذه السياسة قائمة بنقاط الإضافات في قائمة الإجراءات العامة، والتي تعمل كقائمة إعدادات للإضافة. يمكن أن تكون نقطة الإضافة عنوان URL لرابط يتم فتحه أو نقطة نهاية لتنفيذها عند إرسال نموذج.

openLinkUrlPrefixes

array (ListValue format)

لا يمكن لإجراء OpenLink إلا استخدام عنوان URL مع المخطط HTTPS أو MAILTO أو TEL. بالنسبة إلى روابط HTTPS، يجب أن يتطابق عنوان URL أيضًا مع إحدى البادئات المحدّدة في القائمة المسموح بها. إذا غفلت البادئة المخطط، يتم استخدام HTTPS. تتم إعادة كتابة روابط HTTP تلقائيًا لتصبح روابط HTTPS.

LayoutProperties

خصائص تنسيق البطاقة التي تتم مشاركتها في جميع تطبيقات المضيف للإضافة

تمثيل JSON
{
  "primaryColor": string,
  "secondaryColor": string,
  "useNewMaterialDesign": boolean
}
الحقول
primaryColor

string

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

secondaryColor

string

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

useNewMaterialDesign

boolean

تفعيل التصميم متعدد الأبعاد للبطاقات

AddOnWidgetSet

المجموعة الفرعية للتطبيقات المصغّرة التي تستخدمها إحدى الإضافات.

تمثيل JSON
{
  "usedWidgets": [
    enum (WidgetType)
  ]
}
الحقول
usedWidgets[]

enum (WidgetType)

قائمة الأدوات المستخدمة في إحدى الإضافات.

WidgetType

نوع التطبيق المصغّر WIDGET_TYPE_UNSPECIFIED هي مجموعة التطبيقات المصغّرة الأساسية.

عمليات التعداد
WIDGET_TYPE_UNSPECIFIED تم ضبط التطبيق المصغّر التلقائي.
DATE_PICKER أداة اختيار التاريخ
STYLED_BUTTONS تشتمل الأزرار ذات النمط على أزرار معبأة وأزرار غير مفعّلة.
PERSISTENT_FORMS تتيح النماذج الثابتة الاحتفاظ بقيم النماذج أثناء الإجراءات.
UPDATE_SUBJECT_AND_RECIPIENTS تعديل موضوع المسودة ومستلِميها
GRID_WIDGET التطبيق المصغّر للشبكة
ADDON_COMPOSE_UI_ACTION إجراء إضافة Gmail ينطبق على واجهة مستخدم إنشاء الإضافة.

HomepageExtensionPoint

التنسيق الشائع للإعلان عن عرض الصفحة الرئيسية للإضافة.

تمثيل JSON
{
  "runFunction": string,
  "enabled": boolean
}
الحقول
runFunction

string

مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه.

enabled

boolean

اختياريّ. في حال ضبط السياسة على false، سيتم إيقاف عرض الصفحة الرئيسية في هذا السياق.

وفي حال ترك هذه السياسة بدون ضبط، يتم ضبطها تلقائيًا على true.

في حال إيقاف عرض الصفحة الرئيسية المخصّصة لإضافة، سيتم تقديم بطاقة نظرة عامة عامة للمستخدمين بدلاً من ذلك.

UniversalActionExtensionPoint

تنسيق للإعلان عن نقطة إضافة عنصر قائمة الإجراءات العامة.

تمثيل JSON
{
  "label": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
الحقول
label

string

مطلوبة. نص يظهر للمستخدم يصف الإجراء الذي تم اتخاذه من خلال تفعيل نقطة الإضافة هذه، مثل "إضافة جهة اتصال جديدة".

حقل الاتحاد action_type مطلوبة. نوع الإجراء المتوافق مع أحد عناصر قائمة الإجراءات العامة. ويمكن أن يكون رابطًا لفتحه أو نقطة نهاية للتنفيذ. يمكن أن تكون السمة "action_type" واحدة فقط مما يلي:
runFunction

string

نقطة نهاية يتم تشغيلها بواسطة UniversalAction.

GmailAddOnManifest

المواقع التي تخصِّص مظهر إضافة Gmail وتنفيذها

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "authorizationCheckFunction": string
}
الحقول
homepageTrigger

object (HomepageExtensionPoint)

تحدد نقطة نهاية سيتم تنفيذها في سياقات لا تتطابق مع مشغِّل سياقي مُعلَن عنه. ستكون أي بطاقات يتم إنشاؤها من خلال هذه الوظيفة متاحة للمستخدم دائمًا، ولكن قد يحجبها المحتوى السياقي عندما تعرض هذه الإضافة عوامل تشغيل أكثر استهدافًا.

وفي حال توفُّرها، سيتم إلغاء الإعدادات من addons.common.homepageTrigger.

contextualTriggers[]

object (ContextualTrigger)

تحدِّد هذه السياسة مجموعة الشروط التي تؤدي إلى تفعيل الإضافة.

universalActions[]

object (UniversalAction)

لتحديد مجموعة من الإجراءات العامة للإضافة. يشغّل المستخدم الإجراءات العامة من قائمة شريط أدوات الإضافات.

composeTrigger

object (ComposeTrigger)

تحدِّد هذه السياسة مشغِّل وقت الإنشاء للإضافة المخصّصة لوقت الإنشاء. هذا هو المشغِّل الذي يتسبب في اتخاذ الإضافة لإجراء عند إنشاء المستخدم لرسالة إلكترونية. يجب أن تشتمل جميع إضافات وقت الإنشاء على النطاق gmail.addons.current.action.compose على الرغم من أنه قد لا يتم تعديل المسودة.

authorizationCheckFunction

string

اسم نقطة النهاية التي تتحقّق من أنّ الإضافة تتضمّن جميع تفويضات الجهات الخارجية المطلوبة، من خلال فحص واجهات برمجة التطبيقات التابعة لجهة خارجية إذا تعذّر إجراء الفحص، يجب أن تقدِّم الدالة استثناءً لبدء تدفق التفويض. يتم استدعاء هذه الدالة قبل كل استدعاء للإضافة لضمان تجربة سلسة للمستخدم.

ContextualTrigger

يحدد مشغلاً يتم تنشيطه عندما تفي رسالة البريد الإلكتروني المفتوحة بمعايير محددة. عندما يتم تنشيط المشغِّل، فإنه ينفِّذ نقطة نهاية محددة، وذلك عادةً لإنشاء بطاقات جديدة وتحديث واجهة المستخدم.

تمثيل JSON
{
  "onTriggerFunction": string,

  // Union field trigger can be only one of the following:
  "unconditional": {
    object (UnconditionalTrigger)
  }
  // End of list of possible types for union field trigger.
}
الحقول
onTriggerFunction

string

مطلوبة. اسم نقطة النهاية المطلوب طلبها عندما تتطابق رسالة مع المشغِّل.

حقل الاتحاد trigger يحدد نوع المشغِّل الشروط التي يستخدمها Gmail لعرض الإضافة. يمكن أن تكون السمة "trigger" واحدة فقط مما يلي:
unconditional

object (UnconditionalTrigger)

يتم تنفيذ المشغلات غير الشرطية عند فتح أي رسالة بريد.

UnconditionalTrigger

لا يحتوي هذا النوع على أي حقول.

عامل تشغيل يتم تنشيطه عند فتح أي رسالة بريد إلكتروني.

UniversalAction

يشير هذا المصطلح إلى إجراء متاح دائمًا في قائمة شريط أدوات الإضافات بغض النظر عن سياق الرسالة.

تمثيل JSON
{
  "text": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
الحقول
text

string

مطلوبة. نص يظهر للمستخدم يصف الإجراء، مثل "إضافة جهة اتصال جديدة".

حقل الاتحاد action_type يحدد نوع الإجراء سلوك Gmail عند استدعاء المستخدم للإجراء. يمكن أن تكون السمة "action_type" واحدة فقط مما يلي:
runFunction

string

نقطة نهاية يتم استدعاؤها عندما يشغّل المستخدم الإجراء. راجع دليل الإجراءات العامة لمزيد من التفاصيل.

ComposeTrigger

عامل تشغيل يتم تفعيله عندما ينشئ المستخدم رسالة إلكترونية.

تمثيل JSON
{
  "actions": [
    {
      object (MenuItemExtensionPoint)
    }
  ],
  "draftAccess": enum (DraftAccess)
}
الحقول
actions[]

object (MenuItemExtensionPoint)

تحدِّد هذه السياسة مجموعة الإجراءات الخاصة بإضافة وقت الإنشاء. هذه هي الإجراءات التي يمكن للمستخدمين تشغيلها في إضافة وقت الإنشاء.

draftAccess

enum (DraftAccess)

تحدِّد هذه السياسة مستوى الوصول إلى البيانات عند تفعيل إضافة وقت الإنشاء.

DraftAccess

تعداد يحدد مستوى الوصول إلى البيانات الذي يتطلبه مشغل الإنشاء.

عمليات التعداد
UNSPECIFIED القيمة التلقائية عندما لا يتم ضبط أي إعدادات للوصول التمهيدي.
NONE لا يمكن لمشغِّل الإنشاء الوصول إلى أي بيانات في المسودة عند تشغيل إضافة إنشاء.
METADATA يتم منح مشغّل الإنشاء الإذن بالوصول إلى البيانات الوصفية للمسودة عند تشغيل إضافة إنشاء. ويشمل ذلك قائمة المستخدمين، مثل القائمة "إلى" و"نسخة إلى" لمسودة رسالة.

DriveAddOnManifest

المواقع التي تخصِّص مظهر إضافة Drive وتنفيذها.

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onItemsSelectedTrigger": {
    object (DriveExtensionPoint)
  }
}
الحقول
homepageTrigger

object (HomepageExtensionPoint)

وفي حال توفُّرها، سيتم إلغاء الإعدادات من addons.common.homepageTrigger.

onItemsSelectedTrigger

object (DriveExtensionPoint)

يناظر السلوك الذي يتم تنفيذه عند اختيار العناصر في طريقة العرض ذات الصلة في Drive، مثل قائمة المستندات في "ملفاتي".

DriveExtensionPoint

تنسيق شائع للإعلان عن مشغِّلات إضافة Drive

تمثيل JSON
{
  "runFunction": string
}
الحقول
runFunction

string

مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة.

CalendarAddOnManifest

المواقع التي تخصِّص مظهر إضافة "تقويم Google" وتنفيذها

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "createSettingsUrlFunction": string,
  "eventOpenTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventUpdateTrigger": {
    object (CalendarExtensionPoint)
  },
  "currentEventAccess": enum (EventAccess)
}
الحقول
homepageTrigger

object (HomepageExtensionPoint)

تحدد نقطة نهاية يتم تنفيذها في سياقات لا تتطابق مع مشغِّل سياقي مُعلَن عنه. ستكون أي بطاقات يتم إنشاؤها من خلال هذه الوظيفة متاحة للمستخدم دائمًا، ولكن قد يحجبها المحتوى السياقي عندما تعرض هذه الإضافة عوامل تشغيل أكثر استهدافًا.

وفي حال توفُّرها، سيتم إلغاء الإعدادات من addons.common.homepageTrigger.

conferenceSolution[]

object (ConferenceSolution)

تحدّد حلول مكالمات الفيديو التي تقدّمها هذه الإضافة.

createSettingsUrlFunction

string

نقطة نهاية للتنفيذ تؤدي إلى إنشاء عنوان URL لصفحة إعدادات الإضافة

eventOpenTrigger

object (CalendarExtensionPoint)

نقطة نهاية يتم تشغيلها عند فتح حدث لعرضه أو تعديله.

eventUpdateTrigger

object (CalendarExtensionPoint)

نقطة نهاية يتم تشغيلها عند تعديل الحدث المفتوح.

currentEventAccess

enum (EventAccess)

تحدِّد هذه السياسة مستوى الوصول إلى البيانات عند تفعيل إضافة حدث.

ConferenceSolution

تحدِّد هذه السمة القيم ذات الصلة بمكالمة الفيديو.

تمثيل JSON
{
  "onCreateFunction": string,
  "id": string,
  "name": string,
  "logoUrl": string
}
الحقول
onCreateFunction

string

مطلوبة. نقطة النهاية للاتصال عندما يجب إنشاء بيانات مكالمة الفيديو.

id

string

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

name

string

مطلوبة. الاسم المعروض لحل مكالمة الفيديو.

logoUrl

string

مطلوبة. تمثّل هذه السمة عنوان URL لصورة شعار حل مكالمة الفيديو.

CalendarExtensionPoint

تنسيق شائع للإعلان عن مشغّلات إضافة التقويم.

تمثيل JSON
{
  "runFunction": string
}
الحقول
runFunction

string

مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه.

EventAccess

يشير ذلك المصطلح إلى تعداد يحدِّد مستوى مشغِّلات حدث الوصول إلى البيانات المطلوبة.

عمليات التعداد
UNSPECIFIED القيمة التلقائية عندما لا يتم ضبط قيمة eventAccess.
METADATA يمنح هذا الإعداد مشغِّلات الحدث الإذن بالوصول إلى البيانات الوصفية للأحداث، مثل رقم تعريف الحدث ورقم تعريف التقويم.
READ يمنح مشغِّلات الحدث إمكانية الوصول إلى جميع حقول الحدث المُقدّمة، بما في ذلك البيانات الوصفية والضيوف وبيانات مكالمات الفيديو.
WRITE يمنح مشغِّلات الحدث إمكانية الوصول إلى البيانات الوصفية للأحداث وإمكانية تنفيذ جميع الإجراءات، بما في ذلك إضافة الضيوف وإعداد بيانات مكالمات الفيديو.
READ_WRITE يمنح مشغِّلات الحدث إمكانية الوصول إلى جميع حقول الحدث المتوفرة، بما في ذلك البيانات الوصفية والحضور وبيانات مكالمات الفيديو، وإمكانية تنفيذ جميع الإجراءات.

DocsAddOnManifest

المواقع التي تخصِّص مظهر إضافة "مستندات Google" وتنفيذها

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (DocsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ],
  "createActionTriggers": [
    {
      object (CreateActionExtensionPoint)
    }
  ]
}
الحقول
homepageTrigger

object (HomepageExtensionPoint)

وفي حال توفُّرها، سيتم إلغاء الإعدادات من addons.common.homepageTrigger.

onFileScopeGrantedTrigger

object (DocsExtensionPoint)

نقطة نهاية للتنفيذ عند منح تفويض نطاق الملف لهذا المستند/زوج المستخدم.

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

قائمة بنقاط الإضافة لمعاينة الروابط في مستند "مستندات Google" لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة معاينة الروابط باستخدام الشرائح الذكية.

createActionTriggers[]

object (CreateActionExtensionPoint)

قائمة بنقاط الإضافة لإنشاء موارد تابعة لجهات خارجية من داخل تطبيقات Google Workspace

DocsExtensionPoint

تنسيق شائع للإعلان عن مشغِّلات الإضافات في "مستندات Google"

تمثيل JSON
{
  "runFunction": string
}
الحقول
runFunction

string

مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه.

LinkPreviewExtensionPoint

إعدادات المشغِّل الذي يتم تنشيطه عندما يكتب المستخدم رابطًا أو يلصقه من خدمة تابعة لجهة خارجية أو غير تابعة لشركة Google في ملف على "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google".

تمثيل JSON
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "patterns": [
    {
      object (UriPattern)
    }
  ],
  "runFunction": string,
  "logoUrl": string
}
الحقول
labelText

string

مطلوبة. نص مثال لشريحة ذكية يطلب من المستخدمين معاينة الرابط، مثل Example: Support case. يكون هذا النص ثابتًا ويتم عرضه قبل أن ينفِّذ المستخدمون الإضافة.

localizedLabelText

map (key: string, value: string)

اختياريّ. خريطة labeltext للترجمة إلى اللغات الأخرى. يجب تنسيق اللغة وفقًا لمعيار ISO 639 والبلد/المنطقة وفقًا لمعيار ISO 3166، مع الفصل بينهما بواصلة -. مثلاً: en-US

إذا كانت لغة المستخدم موجودة في مفاتيح الخريطة، سيرى المستخدم النسخة المترجَمة من labeltext.

عنصر يحتوي على قائمة من أزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

patterns[]

object (UriPattern)

مطلوبة. مصفوفة من أنماط عناوين URL التي تؤدي إلى تشغيل الإضافة الخاصة بمعاينة الروابط.

runFunction

string

مطلوبة. نقطة نهاية لتنفيذها عند تشغيل معاينة الرابط.

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 فارغًا.

CreateActionExtensionPoint

إعدادات المشغِّل الذي يتم تنشيطه عندما يستدعي المستخدم سير عمل الإنشاء في تطبيق 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.

عنصر يحتوي على قائمة من أزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

runFunction

string

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

logoUrl

string

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

SheetsAddOnManifest

المواقع التي تخصِّص مظهر إضافة وتنفيذها على "جداول بيانات Google"

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SheetsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
الحقول
homepageTrigger

object (HomepageExtensionPoint)

وفي حال توفُّرها، سيتم إلغاء الإعدادات من addons.common.homepageTrigger.

onFileScopeGrantedTrigger

object (SheetsExtensionPoint)

نقطة نهاية للتنفيذ عند منح تفويض نطاق الملف لهذا المستند/زوج المستخدم.

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

قائمة بنقاط الإضافة لمعاينة الروابط في مستند "جداول بيانات Google" لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة معاينة الروابط باستخدام الشرائح الذكية.

SheetsExtensionPoint

التنسيق الشائع للإعلان عن مشغِّلات الإضافة في "جداول بيانات Google".

تمثيل JSON
{
  "runFunction": string
}
الحقول
runFunction

string

مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه.

SlidesAddOnManifest

المواقع التي تخصِّص مظهر إضافة وتنفيذها في "العروض التقديمية من Google".

تمثيل JSON
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SlidesExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
الحقول
homepageTrigger

object (HomepageExtensionPoint)

وفي حال توفُّرها، سيتم إلغاء الإعدادات من addons.common.homepageTrigger.

onFileScopeGrantedTrigger

object (SlidesExtensionPoint)

نقطة نهاية للتنفيذ عند منح تفويض نطاق الملف لهذا المستند/زوج المستخدم.

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

قائمة بنقاط الإضافة لمعاينة الروابط في مستند "العروض التقديمية من Google" لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة معاينة الروابط باستخدام الشرائح الذكية.

SlidesExtensionPoint

تنسيق شائع للإعلان عن مشغِّلات إضافة "العروض التقديمية من Google"

تمثيل JSON
{
  "runFunction": string
}
الحقول
runFunction

string

مطلوبة. نقطة النهاية المطلوب تنفيذها عند تفعيل نقطة الإضافة هذه.

HttpOptions

خيارات إرسال الطلبات إلى نقاط نهاية HTTP للإضافة.

تمثيل JSON
{
  "authorizationHeader": enum (HttpAuthorizationHeader)
}
الحقول
authorizationHeader

enum (HttpAuthorizationHeader)

إعدادات الرمز المميّز الذي تم إرساله في عنوان تفويض HTTP

HttpAuthorizationHeader

تم إرسال رأس التفويض في طلبات إضافة HTTP.

عمليات التعداد
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED القيمة التلقائية، تعادل SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN إرسال رمز مميّز لرقم التعريف لحساب خدمة النظام ضمن "إضافة Google Workspace" الخاص بالمشروع (تلقائي)
USER_ID_TOKEN أرسِل رمزًا مميزًا للمعرّف الخاص بالمستخدم النهائي.
NONE لا ترسِل عنوان مصادقة.

الطُرق

create

ينشئ عملية نشر بالاسم والضبط المحدّدَين.

delete

يؤدي هذا الخيار إلى حذف عملية النشر بالاسم الذي تم إدخاله.

get

يتم الحصول على عملية النشر بالاسم المحدَّد.

getInstallStatus

يحصل على حالة التثبيت لنشر تجريبي.

install

تثبيت عملية نشر في حسابك للاختبار.

list

يسرد جميع عمليات النشر في مشروع معيّن.

replaceDeployment

ينشئ هذا الإعداد عملية نشر أو يستبدلها بالاسم الذي تم تحديده.

uninstall

إلغاء تثبيت نشر تجريبي من حساب المستخدم