مورد بيان "تقويم 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". مواصفات المشغِّل لمشغِّلات تحديث الحدث في "تقويم Google".

eventAttachmentTrigger

object (EventAttachmentTrigger)

مواصفات المشغِّل لمرفقات الحدث في "تقويم Google".

homepageTrigger

object (HomepageTrigger)

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

EventUpdateTrigger

ضبط للمشغل السياقي يتم تشغيله عند تقويم Google يعدّل المستخدم الحدث ويحفظه. عرض تعديل أحداث التقويم لمزيد من المعلومات.

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

string

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

EventAttachmentTrigger

يشير ذلك المصطلح إلى تهيئة لمشغّل سياقي يتم تشغيله عندما ينقر المستخدم على الرابط. موفِّر مرفق الوظيفة الإضافية في القائمة المنسدلة للتقويم.

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

string

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

string

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