مورد بيان "تقويم 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)

مواصفات دالة المشغّل لإنشاء الصفحة الرئيسية الخاصة بالإضافة في تطبيق Calendar المضيف يؤدي هذا الإجراء إلى إلغاء 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

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

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

string

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

string

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