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

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

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

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

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

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

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

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

كيفية تحديد مساحة اجتماع في 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) الخاص بعنصر الأداة وإرجاعه كجزء من عنصر المورد.