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

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

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

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

EventOpenTrigger

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

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

string

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

EventUpdateTrigger

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

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

string

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

EventAttachmentTrigger

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

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

string

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

string

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