مورد بيان "تقويم Google"

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

التقويم

إعدادات بيان إضافات Google Workspace لإضافة إضافات "تقويم Google" اطّلِع على توسيع نطاق "تقويم 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

لا يتم استخدام هذا الحقل إلا إذا كانت الإضافة توفّر الحلول لمكالمات الفيديو. اختيارية: اسم دالة Apps Script التي تنشئ عنوان 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.

ConferenceSolution

إعدادات حلّ مكالمات الفيديو الذي تقدّمه الإضافة يتضمّن كل حلّ خيار مكالمات فيديو ملائمًا معروضًا في واجهة مستخدم تعديل الحدث في "تقويم 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

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

EventOpenTrigger

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

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

string

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

EventUpdateTrigger

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

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

string

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

EventAttachmentTrigger

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

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

string

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

string

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