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

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

object (EventAttachmentTrigger)

تحديد مشغّل لمشغّلات مرفقات الأحداث في "تقويم Google"
homepageTrigger

object (HomepageTrigger)

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

ConferenceSolution

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

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

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

string

مَعلمة مطلوبة. تمثّل هذه السمة معرّف منصة لمكالمات الفيديو. يجب أن يكون المعرّف فريدًا ضمن مجموعة حلول المؤتمرات. لا تغيِّر المعرّف بعد اختياره.
logoUrl

string

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

يجب أن تتم استضافة الصورة على بنية Google الأساسية. لمزيد من التفاصيل، يُرجى الاطّلاع على تقديم شعارات حلول المؤتمرات.

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

string

مَعلمة مطلوبة. اسم منصة لمكالمات فيديو المعروضة في واجهة مستخدم "تقويم Google".
onCreateFunction

string

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

EventOpenTrigger

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

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

string

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

EventUpdateTrigger

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

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

string

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

EventAttachmentTrigger

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

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

string

مطلوبة اسم دالة برمجة تطبيقات التي يتم تنفيذها عندما يختار المستخدم مقدّم الخدمة. يجب أن تعرض الدالة صفيفًا من عناصر Card لواجهة المستخدم.
label

string

مطلوبة نص القائمة الذي يحدّد موفّر المرفقات