إنشاء إضافات خاصة بمكالمات الفيديو

إنّ إجراء إنشاء إضافة Google Workspace توفّر حلول اجتماعات فيديو تابعة لجهات خارجية في "تقويم Google" هو نفسه إجراء إنشاء إضافات Google Workspace، مع بعض الخطوات الإضافية (الموضّحة بالخط العريض أدناه):

  1. اختَر مالك مشروع إضافة ومتعاونين.
  2. أنشئ مشروعًا في "برمجة تطبيقات Google".
  3. تصميم مظهر الإضافة وسلوكها
  4. فعِّل خدمة "تقويم Google" المتقدّمة.
  5. اضبط بيان مشروع الإضافة.
    1. تحديد حلول مكالمات الفيديو في البيان
  6. اكتب رمزًا برمجيًا لتحديد مظهر الإضافة وسلوكها باستخدام خدمة البطاقات المضمّنة في Apps Script.
    1. كتابة رمز برمجي لإدارة حلول المؤتمرات باستخدام خدمة ConferenceData المضمّنة في "برمجة تطبيقات Google"
    2. (اختياري) إنشاء صفحة إعدادات إضافة وضبطها
  7. تحقَّق من نطاقات OAuth الخاصة بالإضافة.
  8. اختبِر الإضافة ضمن التطبيقات المضيفة التي توسّعها.
  9. نشر الإضافة

تقدّم هذه الصفحة نظرة عامة على كل خطوة من الخطوات الجديدة (راجِع مقالة إنشاء إضافات Google Workspace للحصول على نظرة عامة على الخطوات الأخرى).

تفعيل خدمة "تقويم Google" المتقدّمة

تتيح لك الخدمة المتقدّمة في "تقويم Google" استدعاء واجهة برمجة التطبيقات في "تقويم Google" مباشرةً من مشروع Apps Script. لا يمكن تنفيذ بعض العمليات الشائعة، مثل مزامنة أحداث التقويم، إلا باستخدام الخدمة المتقدّمة. قبل أن تتمكّن من استخدام الخدمة المتقدّمة، يجب تفعيلها لمشروع الإضافة.

يمكنك تفعيل خدمة "تقويم Google" المتقدّمة من محرِّر "برمجة التطبيقات". احرص على تفعيل واجهة برمجة التطبيقات في كلٍّ من مربّع الحوار خدمات Google المتقدّمة في المحرّر وفي Google API Console.

تحديد حلول مكالمات الفيديو في البيان

يوفّر بيان الإضافة المعلومات الأساسية التي يحتاجها "تقويم Google" لعرض حلول مكالمات الفيديو الخاصة بالإضافة وتفعيلها بشكل صحيح. يجب أن يحدّد بيان الإضافة (في القسم calendar) حلاً واحدًا أو أكثر للاجتماعات يصف أنواع الاجتماعات التي يمكن أن تستخدمها أحداث "تقويم Google" التابعة لجهات خارجية.

راجِع ملفات البيان للحصول على تفاصيل حول كيفية ضبط ملف بيان الإضافة.

إضافة رمز لإنشاء مؤتمرات ومزامنتها

بعد إنشاء مشروع نص برمجي، يمكنك البدء بإضافة الرمز لتحديد السلوك المرتبط بعقد المؤتمرات في الإضافة. يمكنك استخدام خدمة "تقويم Google" المتقدّمة وخدمة ConferenceData وغيرها من خدمات Apps Script للتحكّم في هذا السلوك.

أثناء إضافة رمز معالجة الاجتماعات إلى الإضافة، عليك إضافة رمز لإنشاء اجتماعات ومزامنة تغييرات التقويم، ويمكنك اختياريًا إضافة صفحة إعدادات.

راجِع دليل أسلوب الإضافات أثناء كتابة الرمز للحصول على إرشادات حول كيفية تصميم تجربة المستخدم للإضافة.

إنشاء مكالمات فيديو

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

لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إنشاء مؤتمرات تابعة لجهات خارجية.

مزامنة تغييرات التقويم

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

لمزيد من التفاصيل، راجِع مقالة مزامنة تغييرات التقويم.

إضافة إعدادات

قد تحتاج إلى إعدادات اختيارية تتيح للمستخدمين ضبط الإضافة. على سبيل المثال، قد تريد السماح للمستخدمين بضبط مَعلمات الاجتماع أو الملاحظات المرفقة بالاجتماع.

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

إنشاء صفحة إعدادات إضافة هو إجراء اختياري. لمزيد من التفاصيل، يُرجى الاطّلاع على إضافة إعدادات.