تسمح وحدة Zoom بالعمل مع Zoom API ( https://marketplace.zoom.us/docs/guides/ ).
تركيب Zoom Module
يلزم استرداد API Key Secret Key لتطبيق Zoom الخاص بك أولاً ( https://marketplace.zoom.us/develop/create؟source=devdocs ). بعد الرابط ، سترى عدة أنواع من تطبيقات Zoom للاختيار.
سيظهر API Key Secret Key لتطبيق Zoom بعد اختيار نوع التطبيق.
نماذج بيانات Meeting Recurrence
عند تثبيت وحدة Zoom ، يتم أيضًا إنشاء نموذجين افتراضيين للبيانات في المشروع: Meeting Recurrence . يشير الأول إلى كائن مكالمة الفيديو نفسه ، ويكون Recurrence مسؤولاً عن انتظام (تكرار) اجتماع الفيديو هذا. تعتبر BPs التالية مساعدة في إنشاء واستخدام نماذج البيانات هذه:
- Make Zoom Meeting - يقوم بإنشاء كائن من نوع نموذج بيانات Meeting :
- Join_url [ string ] - رابط الاجتماع ؛
- start_time [ datetime ] - وقت بدء الاجتماع ؛
- Status [ string ] - حالة الاجتماع ؛
- Type [ enum ] - نوع الاجتماع
- Instant - غير مجدول ، اجتماع لمرة واحدة
- Scheduled - اجتماع مجدول
- Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
- Recurring with fixed time - متكرر بوقت ثابت
- Meeting_id [ integer ] - معرف الاجتماع ؛
- Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
- Topic [ string ] - موضوع الاجتماع؛
- Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
- Password [ string ] - كلمة مرور الاجتماع ؛
- Expand Zoom Meeting - لتوسيع كائن من نوع نموذج بيانات Meeting ؛
- Join_url [ string ] - رابط الاجتماع ؛
- start_time [ datetime ] - وقت بدء الاجتماع ؛
- Status [ string ] - حالة الاجتماع ؛
- Type [ enum ] - نوع الاجتماع
- Instant - غير مجدول ، اجتماع لمرة واحدة
- Scheduled - اجتماع مجدول
- Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
- Recurring with fixed time - متكرر بوقت ثابت
- Meeting_id [ integer ] - معرف الاجتماع ؛
- Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
- Topic [ string ] - موضوع الاجتماع؛
- Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
- Password [ string ] - كلمة مرور الاجتماع ؛
- Make Zoom Recurrence - إنشاء كائن من نوع نموذج بيانات Recurrence ؛
- Type [ enum ] - نوع التكرار
- Daily
- Weekly
- Monthly
- Ends_time [ integer ] - عدد المرات التي سيحدث فيها الاجتماع المتكرر قبل إلغاؤه ، بين القيمة 1 و 50. لا يمكنك استخدام هذا المفتاح مع مفتاح end_date_time .
- Monthly_day [ integer ] - مطلوب فقط للاجتماعات المتكررة الشهرية. يوم الشهر الذي يقع فيه الاجتماع المتكرر ، بين 1 و 31.
- Weekly_days [ enum ] - مطلوب فقط للاجتماعات الأسبوعية المتكررة (1 - الاثنين ، 2 - الثلاثاء ، ... ، 7 - الأحد).
- Repeat_interval [ integer ] - فترة تكرار الاجتماع. لفترة يومية ، بحد أقصى 90 يومًا. لفترة أسبوعية ، بحد أقصى 12 أسبوعًا.
- End_date_time [ datetime ] - تاريخ ووقت الانتهاء النهائي للاجتماع المتكرر قبل أن يتم إلغاؤه ، بتنسيق UTC. لا يمكنك استخدام هذا المفتاح مع مفتاح end_times .
- Type [ enum ] - نوع التكرار
- Expand Zoom Recurrence - يوسع كائن من نوع نموذج بيانات Recurrence ؛
- Type [ enum ] - نوع التكرار
- Daily
- Weekly
- Monthly
- Ends_time [ integer ] - عدد المرات التي سيحدث فيها الاجتماع المتكرر قبل إلغاؤه ، بين القيمة 1 و 50. لا يمكنك استخدام هذا المفتاح مع مفتاح end_date_time .
- Monthly_day [ integer ] - مطلوب فقط للاجتماعات المتكررة الشهرية. يوم الشهر الذي يقع فيه الاجتماع المتكرر ، بين 1 و 31.
- Weekly_days [ enum ] - مطلوب فقط للاجتماعات الأسبوعية المتكررة (1 - الاثنين ، 2 - الثلاثاء ، ... ، 7 - الأحد).
- Repeat_interval [ integer ] - فترة تكرار الاجتماع. لفترة يومية ، بحد أقصى 90 يومًا. لفترة أسبوعية ، بحد أقصى 12 أسبوعًا.
- End_date_time [ datetime ] - تاريخ ووقت الانتهاء النهائي للاجتماع المتكرر قبل أن يتم إلغاؤه ، بتنسيق UTC. لا يمكنك استخدام هذا المفتاح مع مفتاح end_times .
- Type [ enum ] - نوع التكرار
عمليات الأعمال التي تعمل مع Zoom Module
تتوفر عمليات أعمال وحدة Zoom المثبتة مسبقًا للواجهة الخلفية للتطبيق فقط:
- Zoom: Get meeting - الحصول على كائن الاجتماع بالمعرف المحدد:
- Meeting_id [ integer ] - معرف الاجتماع ؛
- Zoom: Delete meeting - يحذف سجل الاجتماع من قاعدة DB المحدد ؛
- Meeting_id [ integer ] (مطلوب) - معرف الاجتماع ؛
- Zoom: Update meeting - تحديث كائن الاجتماع في قاعدة DB المحدد:
- Meeting_id [ integer ] (مطلوب) - معرف الاجتماع ؛
- Topic [ string ] - موضوع الاجتماع؛
- Type [ enum ] - نوع الاجتماع
- Instant - غير مجدول ، اجتماع لمرة واحدة
- Scheduled - اجتماع مجدول
- Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
- Recurring with fixed time - متكرر بوقت ثابت
- start_time [ datetime ] - وقت بدء الاجتماع ؛
- Join_url [ string ] - رابط الاجتماع ؛
- Password [ string ] - كلمة مرور الاجتماع ؛
- Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
- Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
- Zoom: Create Meeting - إنشاء كائن من نوع نموذج بيانات Meeting :
- Type [ enum ] - نوع الاجتماع
- Instant - غير مجدول ، اجتماع لمرة واحدة
- Scheduled - اجتماع مجدول
- Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
- Recurring with fixed time - متكرر بوقت ثابت
- Password [ string ] - كلمة مرور الاجتماع ؛
- Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
- Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
- User_id [ string ] (مطلوب) - ID المستخدم أو عنوان البريد الإلكتروني.
- Type [ enum ] - نوع الاجتماع
- Zoom: List meetings - استخدم API هذه لسرد الاجتماعات المجدولة للمستخدم (مضيف الاجتماع). يتم تعريف المستخدم API_KEY الخاصة به ؛
- Page_size [ integer ] - عدد السجلات التي يتم إرجاعها خلال استدعاء API واحد. تم تعيينه على 30 بشكل افتراضي.
- Page_number [ integer ] - رقم صفحة الصفحة الحالية في السجلات التي تم إرجاعها. تم تعيينه على 1 افتراضيًا.
مثال على الاستخدام
لنلقِ نظرة على مثال لتوليد رابط اجتماع Zoom عند النقر على الزر. لاستخدام العمليات التجارية للوحدة النمطية في الواجهة الأمامية للتطبيق ، فإن الخطوة الأولى هي تعيين Endpoint لإنشاء إنشاء الارتباط (تكبير / Zoom: Create meeting ).
- أنشئ مجموعة جديدة في قسم Endpoints .
- عندما يتم إنشاء المجموعة ، تحتاج إلى إنشاء Endpoint جديدة. Zoom: Create meeting بمثابة نوع طلب POST .
- في عملية أعمال تطبيق الويب ، يمكن استخدام نقطة النهاية المنشأة حديثًا كما في المثال أدناه. هنا ، يتم إنشاء ارتباط وتقديمه كخاصية Label لمكون Label عند النقر فوق الزر ( onClick ) .
النتيجة مبينة أدناه: