مورد بيان "تقويم 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" التي يتم استدعاؤها عند محاولة "تقويم Google" إنشاء هذا النوع من مكالمات الفيديو. يجب تنفيذ هذه الدالة لكل حل لمكالمات الفيديو تتوافق الإضافة معه.

EventOpenTrigger

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

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

string

اسم وظيفة "برمجة تطبيقات Google" التي يتم تشغيلها عندما يفتح المستخدم حدث "تقويم 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" التي تحدِّد موفِّر المرفقات هذا.