مورد بيان التقويم

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

التقويم

يتم ضبط بيان إضافة Google Workspace لإضافات "تقويم Google". يُرجى الاطّلاع على مقالة توسيع نطاق التقويم باستخدام إضافات Google Workspace لمزيد من المعلومات.

تمثيل JSON
{
  "createSettingsUrlFunction": string,
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "currentEventAccess": string,
  "eventOpenTrigger": {
    object (EventOpenTrigger)
  },
  "eventUpdateTrigger": {
    object (EventUpdateTrigger)
  },
  "eventAttachmentTrigger": {
    object (EventAttachmentTrigger)
  },
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
الحقول
createSettingsUrlFunction

string

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

يُرجى الاطّلاع على إضافة إعدادات إضافات مكالمات الفيديو للحصول على مزيد من التفاصيل.
conferenceSolution[]

object (ConferenceSolution)

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

string

تحدِّد مستوى وصول الإضافة إلى بيانات أحداث البيانات التي ينشئها المستخدم. وفي حال عدم توفيرها، لن يتم تمرير أي بيانات وصفية للحدث إلى الإضافة. في ما يلي الإعدادات الصالحة:

  • تشير السمة METADATA إلى أنّ الإضافة يمكنها الوصول فقط إلى البيانات الوصفية الأساسية للحدث.
  • تشير السمة READ إلى أنّ الإضافة يمكنها قراءة بيانات الأحداث التي ينشئها المستخدمون، بالإضافة إلى البيانات الوصفية الأساسية للفعاليات.
  • تشير السمة WRITE إلى أنّ الإضافة يمكنها كتابة بيانات الأحداث التي ينشئها المستخدم.
  • تشير السمة READ_WRITE إلى أنّ الإضافة يمكنها قراءة بيانات الأحداث التي ينشئها المستخدمون وكتابتها، بالإضافة إلى قراءة البيانات الوصفية الأساسية.

في حال ضبط الإضافة على READ أو READ_WRITE، يجب أن تتضمّن الإضافة النطاق https://www.googleapis.com/auth/calendar.addons.current.event.read.

في حال ضبطها على WRITE أو READ_WRITE، يجب أن تتضمّن الإضافة https://www.googleapis.com/auth/calendar.addons.current.event.write النطاق.

eventOpenTrigger

object (EventOpenTrigger)

مواصفات عامل التشغيل لعوامل التشغيل المفتوحة للحدث في "تقويم Google".

eventUpdateTrigger

object (EventUpdateTrigger)

يجب توفير واجهات تعديل الأحداث حسب السياق في "تقويم Google". مواصفات مشغِّل تحديث الأحداث في "تقويم Google".

eventAttachmentTrigger

object (EventAttachmentTrigger)

مواصفات مشغِّل مرفقات الحدث في "تقويم Google".

homepageTrigger

object (HomepageTrigger)

مواصفات دالة التشغيل لإنشاء الصفحة الرئيسية للإضافة في مضيف "تقويم Google". يؤدي هذا الإجراء إلى إلغاء addOns.common.homepageTrigger.

حلّ مكالمة الفيديو

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

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

string

مَعلمة مطلوبة. معرّف لحلّ مكالمات الفيديو ويجب أن يكون فريدًا ضمن مجموعة حلول مكالمات الفيديو المقدّمة للإضافة. ولن تتمكّن من تغيير المعرّف بعد اختياره.
logoUrl

string

رابط إلى الأيقونة التي تمثل الحل. يجب أن يكون حجم الصورة 96 × 96 بكسل مستقل الكثافة.

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

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

string

مَعلمة مطلوبة. اسم حل مكالمات الفيديو الذي يظهر في واجهة مستخدم "تقويم Google" عندما ينشئ المستخدم حدثًا أو يعدّله.
onCreateFunction

string

مَعلمة مطلوبة. اسم وظيفة "برمجة تطبيقات Google" التي يتم استدعاؤها عندما يحاول "تقويم Google" إنشاء هذا النوع من مكالمات الفيديو. يجب تنفيذ هذه الدالة لكل حل مكالمات فيديو متوافق مع الإضافة.

عامل تشغيل EventOpen

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

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

string

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

عامل تشغيل تحديث الحدث

يشير ذلك المصطلح إلى إعداد لمشغِّل سياقي يتم تنشيطه عندما يعدِّل المستخدِم حدث "تقويم Google" وحفظه. يمكنك الاطّلاع على تعديل أحداث "تقويم Google" للحصول على مزيد من المعلومات.

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

string

اسم وظيفة "برمجة تطبيقات Google" التي يتم تشغيلها عندما يُعدّل المستخدم حدث "تقويم Google" ويحفظه. وفي حال تحديد ذلك، يجب تنفيذ هذه الدالة لإنشاء مصفوفة من عناصر Card وعرضها في واجهة المستخدم الخاصة بالإضافة.

عامل تشغيل المرفق

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

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

string

يجب ملء هذا الحقل. اسم وظيفة "برمجة تطبيقات Google" التي تعمل عندما يختار المستخدم موفّر مرفقات الإضافة في القائمة المنسدلة "تقويم Google". يجب تنفيذ هذه الدالة لإنشاء مصفوفة من عناصر Card وعرضها في واجهة مستخدم الإضافة.
label

string

يجب ملء هذا الحقل. النص الذي سيظهر في القائمة المنسدلة "التقويم" التي تحدد موفّر المرفقات هذا.