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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

تقويم 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

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

في حال ضبط الإعدادات على 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

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

string

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

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

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

string

Required. اسم حلّ المكالمة المعروض في واجهة مستخدم "تقويم Google" عندما يُنشئ المستخدم حدثًا أو يعدّله.
onCreateFunction

string

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

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

إعدادات العامل المشغِّل للمحتوى التي يتم تنشيطها عندما يفتح المستخدم حدث "تقويم 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

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

string

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