مرجع الإضافة.yaml

يحتوي ملف مواصفات الإضافة (extension.yaml) على البيانات الوصفية للإضافة، ويحدّد الموارد التي تم إنشاؤها بواسطة الإضافة وواجهات برمجة التطبيقات وإمكانية الوصول التي تتطلبها الإضافة، ويحدّد أي معلَمات تم ضبطها من قِبل المستخدم توفّرها الإضافة.

توضّح الجداول في هذه الصفحة الحقول المتاحة لملف extension.yaml.

المعلومات الأساسية والمعلومات التي تكشف الهوية

name: your-extension-name
version: 1.0.0         # Semantic versioning (semver)
specVersion: v1beta    # Always "v1beta"
license: Apache-2.0    # Always "Apache-2.0" (required to publish on extensions.dev)
billingRequired: true  # Always "true"

displayName: Your extension name
description: >-
  Description of the extension. (One or two
  sentences.)
icon: icon.png
tags: [tag, anothertag]

sourceUrl: https://github.com/your-org/your-repo   # GitHub repo URL
releaseNotesUrl: https://github.com/your-org/your-repo/blob/main/CHANGELOG.md

author:
  authorName: Your Company
  email: extensions@example.com
  url: https://example.com/
contributors:
  - authorName: Your Name
  - authorName: Another Contributor
    email: colleague@example.net
    url: https://github.com/their-org/
الحقول الأساسية
name
string
(مطلوب)

معرّف الإضافة

يمكن أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط، وبحدّ أقصى 40 حرفًا.

ملاحظة: تُستخدَم هذه القيمة لإنشاء رقم تعريف مثيل الإضافة (الذي يُستخدَم بعد ذلك لإنشاء أسماء حساب خدمة الإضافة والموارد الخاصة بالإضافة).

version
string
(مطلوب)

إصدار الإضافة

يجب أن يتّبع الإصدار نظام semver (على سبيل المثال، 1.2.0).

specVersion
string
(مطلوب)

إصدار مواصفات إضافات Firebase

القيمة الحالية: v1beta

license
string
(اختياري)

ترخيص الإضافة

يجب ترخيص الإضافة باستخدام Apache-2.0.

billingRequired
boolean
(اختياري)

ما إذا كانت الخدمات التي تستخدمها الإضافة تتطلّب حساب فوترة Firebase من فئة مدفوعة

يتم ضبطها دائمًا على true.

displayName
string
(اختياري)

الاسم المعروض للإضافة (من 3 إلى 5 كلمات)

الحد الأقصى المسموح به هو 40 حرفًا.

description
string
(اختياري)
وصف موجز للمهمة التي تؤديها الإضافة (جملة واحدة تقريبًا)
icon
string
(اختياري)

الملف الذي سيتم استخدامه كرمز للإضافة على extensions.dev و وحدة تحكّم Firebase.

يجب أن يكون هذا الملف بتنسيق PNG مربّع الشكل وبدقة تتراوح بين 512×512 و1024×1024 بكسل. ضع الملف في الدليل نفسه الذي يتضمّن extension.yaml، ولا يمكنك تحديد دليل فرعي.

يُرجى مراعاة الإرشادات التالية عند تصميم رمز لإضافتك:

  • اختَر ألوان الخلفية والأعمال الفنية المناسبة لعلامتك التجارية.
  • استخدِم ألوانًا بسيطة للرمز، ولا تستخدِم أكثر من لونَين. قد يؤدي استخدام ألوان متعددة إلى جعل الرمز مربكًا من الناحية المرئية.
  • للسبب نفسه، لا تستخدِم تدرّجات الألوان في الرمز. يصعب تمييز التدرجات في الأحجام الصغيرة، كما أنّها تجعل الرمز معقدًا من الناحية المرئية.
  • استخدِم صورًا بسيطة وفريدة توضّح وظيفة الإضافة.
  • إذا كانت شركتك تنشئ إضافات متعددة، لا تستخدم شعارك كرمز. سيواجه المستخدمون صعوبة في التمييز بين إضافاتك.
  • يجب أن يكون العمل الفني جريئًا وواضحًا. لا تستخدِم أعمالاً فنية دقيقة أو معقّدة، لأنّها لن تظهر بشكل جيد في الأحجام الأصغر.
  • لا تُدرِج كلمات توضّح وظيفة الإضافة. غالبًا ما يكون النص غير مقروء في الأحجام الأصغر.
tags
قائمة سلاسل
(اختيارية)
علامات لمساعدة المستخدمين في العثور على الإضافة تتوافق العلامات التالية مع الفئات في Extensions Hub: marketing، messaging، payments، search، shipping، social، utilities، ai
sourceUrl
string
(اختياري)
عنوان URL متاح للجميع يمكن من خلاله الوصول إلى دليل الإضافة
releaseNotesUrl
string
(اختياري)
عنوان URL علني يمكن من خلاله الوصول إلى ملاحظات الإصدار الخاصة بالإضافة
author
كائن مؤلف واحد
(اختياري)

المؤلف الأساسي وجهة الاتصال الأساسية للإضافة

author:
  authorName: Your Company
  email: extensions@example.com
  url: https://example.com/
حقول المؤلف
authorName
string
(مطلوب)

اسم المؤلف

يمكن أن يكون شخصًا أو شركة أو مؤسسة أو غير ذلك.

email
string
(اختيارية)
عنوان البريد الإلكتروني للمؤلف
url
string
(اختيارية)
عنوان URL متاح للجميع يمكن من خلاله الوصول إلى معلومات عن المؤلف
contributors
قائمة بعناصر المؤلفين
(اختيارية)

أي مؤلفين مساهمين إضافيين في الإضافة

contributors:
  - authorName: Your Name
  - authorName: Another Contributor
    email: colleague@example.net
    url: https://github.com/their-org/
حقول المؤلف
authorName
string
(مطلوب)

اسم المؤلف

يمكن أن يكون شخصًا أو شركة أو مؤسسة أو غير ذلك.

email
string
(اختيارية)
عنوان البريد الإلكتروني للمؤلف
url
string
(اختيارية)
عنوان URL متاح للجميع يمكن من خلاله الوصول إلى معلومات عن المؤلف

واجهات برمجة التطبيقات في Firebase وGoogle Cloud

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

apis:
  - apiName: apiname.googleapis.com
    reason: Explanation of why the extension uses this API
  - apiName: anotherapiname.googleapis.com
    reason: Explanation of why the extension uses this API
حقول واجهة برمجة التطبيقات
apiName
string
(مطلوب)

اسم Google API

يجب أن يتطابق مع حقل اسم الخدمة كما هو مُدرَج في صفحة النظرة العامة لكل واجهة برمجة تطبيقات (مثال) في مكتبة Google Cloud API

reason
string
(مطلوب)
وصف موجز لسبب حاجة الإضافة إلى استخدام واجهة برمجة التطبيقات هذه

أدوار "إدارة الهوية وإمكانية الوصول"

تحدّد هذه الحقول أدوار Cloud IAM التي تتطلّبها الإضافة. ويتم منح هذه الأدوار لحساب الخدمة الذي تم توفيره للإضافة.

يمكنك تحديد أحد الأدوار المتوافقة فقط.

roles:
  - role: product.role
    reason: Explanation of why the extension needs this level of access
  - role: anotherproduct.role
    resource: projects/${project_id}/resource_type/*
    reason: Explanation of why the extension needs this level of access
حقول الأدوار
role
string
(مطلوب)

اسم دور "إدارة الهوية وإمكانية الوصول" اللازم لتشغيل الإضافة

يجب أن يكون أحد الأدوار المتوافقة

reason
string
(مطلوب)
وصف موجز لسبب حاجة الإضافة إلى الوصول الممنوح من خلال هذا الدور
resource
string
(اختياري)

يمكنك حصر نطاق الدور في هذا المورد.

في حال عدم إدخال قيمة، يتم استخدام projects/${project_id} كقيمة تلقائية. يُرجى الاطّلاع على تقليل نطاق الأدوار.

الخدمات الخارجية

تحدّد هذه الحقول الخدمات غير التابعة لـ Firebase وغير التابعة لـ Google التي تستخدمها الإضافة (عادةً واجهات برمجة تطبيقات REST). لا توفّر منصة "إضافات Firebase" أي وسيلة لتفعيل هذه الخدمات أو إجراء التفويض لها تلقائيًا.

externalServices:
  - name: Example API
    pricingUri: https://developers.example.com/pricing
  - name: Another Example API
    pricingUri: https://developers.example.com/pricing
حقول الخدمات الخارجية
name
string
(مطلوب)
اسم الخدمة الخارجية اللازمة لتشغيل الإضافة
pricingUri
string
(مطلوب)
معرّف الموارد المنتظم (URI) لمعلومات الأسعار الخاصة بالخدمة

المَعلمات التي يمكن للمستخدم ضبطها

تحدّد هذه الحقول المَعلمات التي تتيحها الإضافة للمستخدمين لضبطها.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      What do you want to set PARAM_ID to?
      This is a longer description of the parameter, often phrased as a prompt
      to the user.
  - param: ANOTHER_PARAM_ID
    label: Short description of the parameter
    description: >
      What do you want to set ANOTHER_PARAM_ID to?
      This is a longer description of the parameter.
    example: example-input
    validationRegex: "^[a-zA-Z][a-zA-Z-]*[a-zA-Z]?$"
    validationErrorMessage:
      Must be a hyphen-delimited string of alphabetic characters
    default: default-value
    required: false
    immutable: true
حقول المَعلمات
param
string
(مطلوب)
اسم المَعلمة يمكنك استخدام هذا الاسم للإشارة إلى قيمة المَعلمة في الرمز البرمجي.
label
string
(مطلوب)
وصف موجز للمَعلمة يتم عرضها للمستخدم عندما يُطلب منه إدخال قيمة المَعلمة.
description
string
(اختياري)

وصف تفصيلي للمَعلمة يتم عرضها للمستخدم عندما يُطلب منه إدخال قيمة المَعلمة.

يتيح استخدام Markdown.

example
string
(اختياري)
مثال على قيمة المَعلمة
default
string
(اختياري)
القيمة التلقائية للمَعلمة إذا ترك المستخدم قيمة المَعلمة فارغة.
validationRegex
string
(اختياري)
تعبير عادي للتحقّق من صحة القيمة التي ضبطها المستخدم للمَعلمة بنية التعبير العادي حسب مواصفات Google RE2
validationErrorMessage
string
(اختياري)
رسالة الخطأ التي تظهر في حال تعذّر التحقّق من التعبير النمطي
required
boolean
(اختياري)
تحدّد ما إذا كان بإمكان المستخدم إرسال سلسلة فارغة عندما يُطلب منه إدخال قيمة المَعلمة. القيمة التلقائية هي true.
immutable
boolean
(اختياري)

تحدّد ما إذا كان بإمكان المستخدم تغيير قيمة المَعلمة بعد التثبيت (مثلاً، في حال إعادة ضبط الإضافة). القيمة التلقائية هي false.

ملاحظة: إذا حدّدت مَعلمة "location" للدوال المنشورة في الإضافة، اضبط هذا الحقل على true.

type
string
(اختياري)
نوع المَعلمة قد تتطلّب أنواع المَعلمات الخاصة متطلبات إضافية أو عرضًا مختلفًا لواجهة المستخدم. يُرجى الاطّلاع على الأقسام التالية.

المَعلمات القابلة للاختيار والمتعدّدة الاختيار

تطلب المَعلمات القابلة للاختيار والمتعدّدة الاختيار من المستخدمين الاختيار من قائمة الخيارات المحدّدة مسبقًا.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      Do you want to enable the option?
    type: select
    options:
      - label: Yes
        value: true
      - label: No
        value: false
  - param: ANOTHER_PARAM_ID
    label: Short description of the parameter
    description: >-
      Which options do you want to enable?
    type: multiSelect
    options:
      - value: red
      - value: green
      - value: blue
حقول المَعلمات ذات الخيارات المتعدّدة
type
string

select أو multiSelect

تحدّد هذه السمة أنّ المَعلمة يمكن أن تكون قيمة واحدة (select) أو عدة قيم (multiSelect) يتم اختيارها من مجموعة من الخيارات المحدّدة مسبقًا

options
قائمة الخيارات
(مطلوبة)

الخيارات التي يمكن للمستخدم الاختيار من بينها

حقول الخيارات
value
string
(مطلوب)
إحدى القيم التي يمكن للمستخدم اختيارها هذه هي القيمة التي تحصل عليها عند قراءة قيمة المَعلمة في الرمز البرمجي.
label
string
(اختيارية)
وصف موجز للخيار الذي يمكن تحديده في حال عدم إدخال قيمة، يتم ضبط القيمة تلقائيًا على value.

مَعلمات الموارد القابلة للاختيار

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

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      Which resource do you want to use?
    type: selectresource
    resourceType: product.googleapis.com/ResourceType
حقول معلّمات المرجع
type
string

selectresource

تحدّد أنّ المَعلمة تمثّل مورد مشروع

resourceType
string
(مطلوب)

نوع المرجع الذي سيُطلب من المستخدم اختياره

قيم صالحة:

  • storage.googleapis.com/Bucket
  • firestore.googleapis.com/Database
  • firebasedatabase.googleapis.com/DatabaseInstance

ومع ذلك، تتوفّر حاليًا واجهة مستخدم للاختيار في حِزم Cloud Storage فقط (يتم عرض أنواع الموارد الأخرى كحقول إدخال نصية بتصميم مرن).

المَعلمات السرية

يتم التعامل مع القيم السرية التي يقدّمها المستخدم (مثل مفاتيح واجهة برمجة التطبيقات) بشكل مختلف:

  • يتم تخزين قيم المفاتيح السرية باستخدام Cloud Secret Manager. يمكن فقط للعملاء المصرّح لهم (مثل نسخة مثبّتة من إضافة) الوصول إلى هذه القيم.
  • عندما يُطلب من المستخدمين تقديم هذه القيم، لا يتم عرض ما أدخلوه.
params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      What is the secret value?
    type: secret
حقول المَعلمات السرية
type
string

secret

تحدّد أنّ المَعلمة هي قيمة سرية

موارد Cloud Function

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

الجيل الأول من Cloud Functions

resources:
  - name: functionName
    type: firebaseextensions.v1beta.function
    description: >-
      Description of what the function does. (One or two
      sentences.)
    properties:
      runtime: runtime-version
      eventTrigger:
        eventType: google.product.event
        resource: projects/_/resource/specifier
حقول الموارد
name
string
(مطلوب)

اسم سهل الاستخدام للدالة التي تم تصديرها

إذا لم تحدّد السمة entryPoint (انظر أدناه)، يجب أن تتطابق هذه القيمة مع اسم الدالة في الرمز المصدر للدوال.

سيكون الاسم النهائي للدالة المنشورة بالتنسيق التالي: ext-extension-instance-id-name.

type
string
(مطلوب)
بالنسبة إلى مرجع دالة من الجيل الأول: firebaseextensions.v1beta.function
description
string
(مطلوب)

وصف موجز للمهمة التي تؤديها الدالة للإضافة

properties
(مطلوب)

سمات الجيل الأول من Cloud Functions في ما يلي أهم السمات، ولكن يمكنك العثور على القائمة الكاملة في مرجع Cloud Functions.

المواقع
location
(اختياري)

الموقع الجغرافي الذي سيتم نشر الدالة فيه القيمة التلقائية هي us-central1

entryPoint
(اختياري)
اسم الدالة التي تم تصديرها ضمن الرمز المصدر للدوال التي يجب أن تبحث عنها الإضافة القيمة التلقائية هي قيمة name أعلاه.
sourceDirectory
(اختياري)

الدليل الذي يحتوي على package.json في جذره يجب أن يكون ملف الرمز المصدر للدوال في هذا الدليل. القيمة التلقائية هي functions

ملاحظة: يحدّد الحقل main في package.json الملف الخاص بالرمز المصدر للدوال (مثل index.js).

timeout
(اختياري)

الحدّ الأقصى لوقت تنفيذ الدالة

  • عناوين URL التلقائية: 60s
  • الحد الأقصى للقيمة: 540s
availableMemoryMb
(اختياري)

مقدار الذاكرة بالميغابايت المتاحة للدالة

  • عناوين URL التلقائية: 256
  • القيم الصالحة: 128 و256 و512 و1024 و2048
runtime
(الخيار الذي يُنصح به)

بيئة التشغيل الخاصة بالدالة

‫httpsTrigger
أو
eventTrigger
أو
scheduleTrigger
أو
taskQueueTrigger
(يجب استخدام أحد أنواع مشغّلات الدوال هذه)
يمكنك الاطّلاع على كتابة دوال Cloud Functions لإضافة للحصول على معلومات محدّدة حول كل نوع من أنواع المشغِّلات.

الجيل الثاني من دوال Cloud

resources:
  - name: functionName
    type: firebaseextensions.v1beta.v2function
    description: >-
      Description of what the function does. (One or two
      sentences.)
    properties:
      buildConfig:
        runtime: nodejs16
      serviceConfig:
        availableMemory: 512M
      eventTrigger:
        eventType: google.firebase.firebasealerts.alerts.v1.published
        triggerRegion: global
        eventFilters:
          - attribute: alerttype
            value: crashlytics.newFatalIssue

حقول الموارد
name
string
(مطلوب)

اسم سهل الاستخدام للدالة التي تم تصديرها

إذا لم تحدّد السمة entryPoint (انظر أدناه)، يجب أن تتطابق هذه القيمة مع اسم الدالة في الرمز المصدر للدوال.

سيكون الاسم النهائي للدالة المنشورة بالتنسيق التالي: ext-extension-instance-id-name.

type
string
(مطلوب)
بالنسبة إلى مورد دالة من الجيل الثاني: firebaseextensions.v1beta.v2function
description
string
(مطلوب)

وصف موجز للمهمة التي تؤديها الدالة للإضافة

properties
(مطلوب)

خصائص الجيل الثاني من Cloud Functions في ما يلي أهم السمات، ولكن يمكنك العثور على القائمة الكاملة في مرجع Cloud Functions.

المواقع
location
(اختياري)

الموقع الجغرافي الذي سيتم نشر الدالة فيه القيمة التلقائية هي us-central1

sourceDirectory
(اختياري)

الدليل الذي يحتوي على package.json في جذره يجب أن يكون ملف الرمز المصدر للدوال في هذا الدليل. القيمة التلقائية هي functions

ملاحظة: يحدّد الحقل main في package.json الملف الخاص بالرمز المصدر للدوال (مثل index.js).

هناك أيضًا ثلاثة حقول من نوع العناصر لها خصائصها الخاصة:

سمات buildConfig
buildConfig.runtime
(الخيار الذي يُنصح به)

بيئة التشغيل الخاصة بالدالة

buildConfig.entryPoint
(اختياري)
اسم الدالة التي تم تصديرها ضمن الرمز المصدر للدوال التي يجب أن تبحث عنها الإضافة القيمة التلقائية هي قيمة name أعلاه.
سمات serviceConfig
serviceConfig.timeoutSeconds
(اختياري)

الحدّ الأقصى لوقت تنفيذ الدالة

  • عناوين URL التلقائية: 60
  • الحد الأقصى للقيمة: 540
serviceConfig.availableMemory
(اختياري)
مقدار الذاكرة المتاحة للدالة. القيمة التلقائية هي 256M. الوحدات المتوافقة هي k وM وG وMi وGi. إذا لم يتم توفير وحدة، يتم تفسير القيمة على أنّها بايت.
سمات eventTrigger
eventTrigger.eventType
(مطلوب)
نوع الحدث المطلوب الاستماع إليه يمكنك الاطّلاع على كتابة دوال Cloud لإضافة لمعرفة أنواع الأحداث المتاحة لكل منتج.
eventTrigger.eventFilters
(اختياري)
الفلاتر التي تحدّ من الأحداث التي يتم رصدها على سبيل المثال، يمكنك الاستماع فقط إلى الأحداث التي تتطابق مع نمط مورد محدّد. يمكنك الاطّلاع على كتابة دوال Cloud لإضافة للحصول على معلومات عن فلترة كل نوع من الأحداث.
eventTrigger.channel
(اختياري)
اسم القناة المرتبطة بالمشغّل بتنسيق projects/{project}/locations/{location}/channels/{channel}. في حال حذف هذه السمة، ستستمع الدالة إلى الأحداث على القناة التلقائية للمشروع.
eventTrigger.triggerRegion
(اختياري)
سيتلقّى عامل التفعيل الأحداث التي تنشأ في هذه المنطقة فقط. ويمكن أن تكون المنطقة نفسها التي تقع فيها الدالة أو منطقة مختلفة أو منطقة متعددة أو المنطقة العالمية. وفي حال عدم توفيرها، يتم ضبطها تلقائيًا على المنطقة نفسها التي تتوفّر فيها الدالة.

الأحداث في مراحل النشاط

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

lifecycleEvents:
  onInstall:
    function: myTaskFunction
    processingMessage: Describes the task being completed
  onUpdate:
    function: myOtherTaskFunction
    processingMessage: Describes the task being completed
  onConfigure:
    function: myOtherTaskFunction
    processingMessage: Describes the task being completed
حقول الأحداث التي تتم في مراحل النشاط
onInstall
(اختياري)

تحدِّد دالة يتم تشغيلها عندما يثبِّت المستخدم الإضافة.

مواصفات الدالة
function
string
(مطلوب)

اسم الدالة التي يتم تشغيلها من خلال قائمة انتظار المهام والتي ستتعامل مع الحدث

يجب تعريف هذه الدالة في القسم resources وتحديد taskQueue.

processingMessage
string
(مطلوب)
الرسالة التي ستظهر في وحدة تحكّم Firebase أثناء تنفيذ المهمة
onUpdate
(اختياري)

يحدّد دالة يتم تشغيلها عندما يحدّث المستخدم الإضافة.

مواصفات الدالة
function
string
(مطلوب)

اسم الدالة التي يتم تشغيلها من خلال قائمة انتظار المهام والتي ستتعامل مع الحدث

يجب تعريف هذه الدالة في القسم resources وتحديد taskQueue.

processingMessage
string
(مطلوب)
الرسالة التي ستظهر في وحدة تحكّم Firebase أثناء تنفيذ المهمة
onConfigure
(اختياري)

تحدّد هذه السمة دالة يتم تشغيلها عندما يعيد المستخدم ضبط الإضافة.

مواصفات الدالة
function
string
(مطلوب)

اسم الدالة التي يتم تشغيلها من خلال قائمة انتظار المهام والتي ستتعامل مع الحدث

يجب تعريف هذه الدالة في القسم resources وتحديد taskQueue.

processingMessage
string
(مطلوب)
الرسالة التي ستظهر في وحدة تحكّم Firebase أثناء تنفيذ المهمة

الأحداث المخصّصة (Eventarc)

الأحداث المخصّصة هي أحداث تصدرها الإضافة للسماح للمستخدمين بإدراج المنطق الخاص بهم في الإضافة. يُرجى الاطّلاع على قسم Eventarc في إضافة عناصر جذب المستخدمين إلى إضافة.

events:
  - type: publisher-id.extension-name.version.event-name
    description: Description of the event
  - type: publisher-id.extension-name.version.another-event-name
    description: Description of the other event
حقول الأحداث المخصّصة
type
string
(مطلوب)
معرّف نوع الحدث أنشئ المعرّف من 3 إلى 4 حقول مفصولة بنقاط: حقول الرقم التعريفي للناشر واسم الإضافة واسم الحدث مطلوبة، ويُنصح باستخدام حقل الإصدار. اختَر اسم حدث فريدًا ووصفًا لكل نوع حدث تنشره.
description
string
(مطلوب)
وصف الحدث