نظرة عامة على مساحات الاجتماعات في Google Meet

صورة توضيحية لواجهة Google Meet REST API

يشرح هذا الدليل كيف تتيح لك واجهة برمجة تطبيقات Google Meet REST إنشاء اجتماعات Google Meet وإدارتها.

تمثّل مساحة الاجتماع مكانًا افتراضيًا أو عنصرًا ثابتًا (مثل غرفة اجتماعات) تُعقد فيه المؤتمرات. يمكن عقد اجتماع نشط واحد فقط في مساحة واحدة في أي وقت. تساعد مساحة الاجتماعات أيضًا المستخدمين في الاجتماع والعثور على الموارد المشترَكة.

للعمل مع مساحات الاجتماعات، يُرجى الاطّلاع على إنشاء مساحات اجتماعات وإدارتها. للتعرّف على كيفية ضبط مساحة اجتماع آليًا، يُرجى الاطّلاع على ضبط مساحات الاجتماعات والأعضاء.

كيفية استدعاء طرق مساحة الاجتماع

يوضّح الجدول التالي أدوار الاجتماع المطلوبة لاستخدام طرق مساحة الاجتماع:

الطريقة المالكون مشارك غير ذلك
endActiveConference x
get x x x
     مع الإعدادات x
     مع مكالمة فيديو نشطة x x
patch x

كيفية تحديد مساحة اجتماع في Meet

تنشئ واجهة برمجة تطبيقات Google Meet REST مورد spaces لكل مساحة اجتماع. يوفر مرجع spaces نقاط دخول متعددة للانضمام إلى مؤتمر.

يوضّح الجدول التالي كيفية تحديد مساحة اجتماع والانضمام إليها:

اسم الحقل الوصف
name اسم المساحة السلسلة {space} هي معرّف المورد الخاص بالمساحة، ويتم تنسيقها على النحو التالي: spaces/{space}. وهو معرّف فريد ينشئه الخادم وحسّاس لحالة الأحرف. على سبيل المثال، spaces/jQCFfuBOdN5z.
meetingCode الاسم المستعار لاسم المساحة {meetingCode} هي سلسلة أحرف فريدة يمكن كتابتها وغير حساسة لحالة الأحرف. ويكون التنسيق على النحو التالي: spaces/{meetingCode}. على سبيل المثال، spaces/abc-mnop-xyz. الحد الأقصى للطول هو 128 حرفًا. وهي تشكّل جزءًا من meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess طُرق الوصول إلى هذه المساحة المخصّصة للاجتماعات عبر الهاتف يحتوي العنصر phoneAccess على المعلومات المطلوبة للاتصال بمؤتمر، بما في ذلك أرقام الهواتف الإقليمية لمساحة الاجتماع ورقم التعريف الشخصي الخاص برقم الهاتف هذا. يتألف رقم التعريف الشخصي من أرقام عشرية فقط وقد يختلف طوله. على سبيل المثال، "pin": 19707127300.

على غرار واجهة مستخدم Meet، يتضمّن المرجع spaces مجموعة محدودة من أرقام الاتصال الهاتفي. يمكنك الاطّلاع على أرقام هواتف إضافية لمساحة اجتماع من خلال إضافة {meetingCode} إلى عنوان URL التالي: https://meet.google.com/tel/. على سبيل المثال، https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess طُرق الوصول إلى بروتوكول بدء الجلسة (SIP) لمساحة الاجتماع هذه توضّح عناوين بروتوكول بدء الجلسة (SIP) كيف يمكن لأجهزة مؤتمرات الفيديو التابعة لجهات خارجية العثور على مؤتمر Meet والانضمام إليه. يحتوي الكائن gatewaySipAccess على معرّف موارد منتظم (URI) ورمز وصول رقمي. يتوافق Meet مع مخطّط معرّف الموارد المنتظم (URI) لبروتوكول SIP.

لإدارة مساحة اجتماع، استخدِم القيم التالية للحقل name:

  • للحصول على تفاصيل حول مساحة اجتماع، يمكنك استخدام spaces/{space} أو الاسم المستعار spaces/{meetingCode}. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحصول على مساحة اجتماعات.

  • لتعديل تفاصيل مساحة اجتماع، يمكنك استخدام spaces/{space} فقط. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تعديل مساحة اجتماع.

  • لإنهاء مكالمة فيديو نشطة ضمن مساحة اجتماع، يمكنك استخدام spaces/{space} فقط. لمزيد من المعلومات، يُرجى الاطّلاع على إنهاء مؤتمر نشط.

مراحل نشاط مساحة الاجتماع

تمر مساحة الاجتماع بعدة حالات خلال دورة حياتها. يوضّح المخطّط التالي الخطوات العالية المستوى لدورة حياة مساحة الاجتماع:

دورة حياة مساحة الاجتماعات
الشكل 1. مراحل نشاط مساحة الاجتماعات

  1. اتّصِل بـ spaces.create. يتم إنشاء مساحة الاجتماع ويحتوي العنصر spaces الذي تم عرضه على السلسلة meetingUri. بعد ذلك، يتم توزيع meetingUri على المشاركين.

  2. إجراء استطلاع في مساحة الاجتماع الجديدة استدعِ طريقة spaces.get للتحقّق من حالة المكالمة الجماعية.

    بدلاً من الاستطلاعات، يمكنك أيضًا الاشتراك في أحداث Meet لتلقّي إشعارات فورية.

  3. ابدأ المؤتمر. عندما ينقر المشارك الأول على meetingUri داخل مساحة الاجتماع، يبدأ مؤتمر. تتم تعبئة العنصر activeConference ويتم ضبط السلسلة activeConference.conferenceRecord.

  4. (اختياري) الحصول على بيانات المؤتمر أثناء مؤتمر نشط، يمكنك الوصول إلى بعض قيم conferenceRecord. على سبيل المثال، يمكنك استدعاء الطريقة conferenceRecords.participants.list للاطّلاع على جميع المشاركين في المؤتمر. يمكنك أيضًا الوصول إلى هذه المعلومات لمدة تصل إلى 30 يومًا بعد انتهاء المؤتمر.

  5. (اختياري) إنهاء مكالمة الفيديو أثناء المؤتمر، يمكن لمالك الاجتماع استدعاء الطريقة spaces.endActiveConference لإنهاء مؤتمر نشط لجميع المشاركين آليًا.

  6. تنتهي المكالمة الجماعية. عندما يغادر آخر مشارك، ينتهي المؤتمر.

  7. استطلاع حول بيانات ما بعد المؤتمر انتهى المؤتمر (STATE=ENDED) ولكن لم يتم إنشاء العناصر بعد. يتم أيضًا ملء الحقلين startTime وendTime الخاصين بالمؤتمر. يجب إرسال طلبات إلى نقطة نهاية العنصر حتى يصبح العنصر STATE FILE_GENERATED.

    بدلاً من إجراء استطلاع، يمكنك الاشتراك في أحداث Meet لتلقّي إشعارات فورية.

  8. الحصول على بيانات ما بعد المؤتمر يمكنك استرداد البيانات، مثل التسجيلات والنصوص، بعد إنشائها. على سبيل المثال، استدعِ طريقة conferenceRecords.recordings.get للحصول على تسجيل حسب معرّف التسجيل.

    بعد أن يصبح جاهزًا، تتم تعبئة معرّف الموارد المنتظم (URI) الخاص بكائن العنصر وإرجاعه كجزء من كائن المورد.