نظرة عامة حول Google Meet REST API

تتيح لك Google Meet REST API إنشاء اجتماعات على Google Meet وإدارتها، وتوفر نقاط دخول للمستخدمين مباشرةً من تطبيقك.

باستخدام Meet REST API، يمكنك إجراء ما يلي:

  • أنشئ مساحة اجتماع لربط المستخدمين عبر الفيديو.
  • الحصول على مساحة اجتماع أو مؤتمر حسب اسم المورد
  • الحصول على قائمة بالمشاركين وجلسات المشاركين
  • الحصول على عناصر الاجتماعات (التسجيلات والنصوص وإدخالات النصوص)

يمكنك أيضًا الاشتراك في أحداث Meet باستخدام Google Workspace Events API. لتلقّي إشعارات بالتغييرات، يمكنك الاشتراك في مساحة اجتماع محدّدة أو في جميع مساحات الاجتماعات التي يملكها مستخدم محدّد. لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي الاشتراك في الأحداث باستخدام واجهة برمجة التطبيقات Google Workspace Events API والاشتراك في أحداث Google Meet.

حالات الاستخدام

يمكن للتطبيقات الدمج مع Meet REST API لتنفيذ المهام التالية:

  • قبل بدء المؤتمر: يمكنك تخصيص تجربة المؤتمر حسب الحاجة من خلال إنشاء مساحة الاجتماع. يمكنك أيضًا إدارة المدعوين وضبط الإعدادات مسبقًا.

  • أثناء مؤتمر: استرداد معلومات المؤتمر لتغيير تجربتك في التطبيق استنادًا إلى البيانات الوصفية التي يتم عرضها

  • بعد المؤتمر: يمكنك جلب عناصر المؤتمر، مثل التسجيل وتحويل الصوت إلى نص.

تشمل بعض الأمثلة على الإجراءات التي قد تحتاج إلى استخدام Meet REST API لتنفيذها ما يلي:

  • المبيعات وإدارة الحسابات

    • استرداد معلومات الاجتماع والمشاركين لأغراض التسجيل
    • جلب عناصر الاجتماع ونشرها في الحسابات
    • تشغيل النصوص المسجّلة وتحويلها إلى نص باستخدام نماذج الذكاء الاصطناعي لإنشاء تحليلات حول فعالية التدريب ومبيعات

  • التعلم والتطوير

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

  • عمليات المطوّرين

    • يمكنك إنشاء اجتماعات للتواصل مع زملائك في الفريق على الفور.
    • يمكنك السماح للمعنيّين الآخرين بالانضمام إلى الاجتماعات الجارية من خلال مشاركة معلومات الاجتماع والمشاركين في الوقت الفعلي.
    • تشغيل بيانات النصّ من خلال نماذج الذكاء الاصطناعي لإنشاء الخطوات التالية الصحيحة
يمكنك إنشاء اجتماع ديناميكي مع زملائك والانضمام إليه ضمن مساحة Chat.
الشكل 1. يمكنك إنشاء اجتماع ديناميكي مع زملائك والانضمام إليه ضمن مساحة Chat.

يمكنك أيضًا دمج واجهات برمجة تطبيقات أخرى في Google Workspace، مثل Chat API في تطبيقك لتعزيز التعاون. لمزيد من المعلومات، يُرجى الاطّلاع على حالات استخدام Chat.

عبارات عامة

في ما يلي قائمة بالمصطلحات الشائعة المستخدَمة في واجهة برمجة التطبيقات هذه:

العنصر
ملف أنشأه Meet استجابةً لمؤتمر، مثل التسجيلات و النصوص وعادةً ما يكون العنصر جاهزًا للاسترجاع بعد انتهاء المؤتمر بوقت قصير.
حدث التقويم
حدث في "تقويم Google" يتضمّن عدة ضيوف، ويكون عادةً من إنشاء منظّم اجتماع، ويحتوي على معلومات الانضمام إلى اجتماع. قد يكون Meet هو الحلّ المناسب لعقد مؤتمرات الفيديو في الحدث.
اتصال
جلسة باستخدام Meet أو لإشعار الآخرين بأنّ المكالمة ستبدأ أو جارية والسماح لهم بالانضمام إليها على الفور
المؤتمر
المكالمة الجماعية هي حدث مكالمة ضمن مساحة اجتماع. ويرى المستخدمون عادةً أنّ هذا السيناريو اجتماع واحد.
المضيف المشارك
مستخدم في مكالمة تم منحه امتيازات إدارة المضيف من قِبل أحد المضيفين، باستثناء إمكانية إزالة المضيف الأصلي
المضيف
الشخص الذي أنشأ مكالمة (منظِّم الاجتماع) أو الشخص الذي يتحكّم في المكالمة. يُرجى العِلم أنّه يمكن لمنظم الاجتماع تنظيمه بدون أن يكون حاضرًا عند انعقاده. يمكن للمضيف أيضًا تفويض سوى مزايا المضيف إلى مضيف مشارك.
رمز الاجتماع

سلسلة فريدة من 10 أحرف يمكن كتابتها لـ مساحة اجتماع يتم استخدامها ضمن معرّف الموارد المنتظم للاجتماع لمساحة اجتماع. وهي ليست حسّاسة لحالة الأحرف. على سبيل المثال، abc-mnop-xyz. الحد الأقصى لعدد الأحرف المسموح به هو 128 حرفًا.

يجب عدم تخزين رموز الاجتماعات على المدى الطويل لأنّه يمكن أن يتم فصلها عن مساحة اجتماع ويمكن إعادة استخدامها لمساحات اجتماعات مختلفة في المستقبل. تنتهي صلاحية رموز الاجتماعات بشكل عام بعد 365 يومًا من آخر استخدام. لمزيد من المعلومات، يُرجى الاطّلاع على مزيد من المعلومات عن رموز الاجتماعات في Google Meet.

اسم الاجتماع

معرّف فريد ينشئه الخادم ويُستخدَم لتحديد مساحة اجتماع. وهي حساسة لحالة الأحرف. مثلاً: jQCFfuBOdN5z يتم عرض معرّف الاجتماع في حقل name لمصدر spaces.

منظّم الاجتماع

المستخدم الذي أنشأ مساحة الاجتماع. يمكن أيضًا اعتبار هذا المستخدم مالك الاجتماع. قد لا يكون المضيف متاحًا أثناء المكالمة أو قد لا يكون هو مضيف الاجتماع. لا يمكن أن يكون هناك أكثر من منظِّم اجتماع واحد.

مساحة الاجتماع

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

معرّف الموارد المنتظم للاجتماع

عنوان URL قابل للنقر يُطلق مكالمة أو ينضم إليها المستخدم. تحتوي كل مكالمة على عنوان URL فريد يتألّف من https://meet.google.com/ متبوعًا برمز اجتماع. على سبيل المثال، https://meet.google.com/abc-mnop-xyz.

المشارك

مستخدم انضم إلى مكالمة أو يستخدم وضع المزاملة، أو يشاهد المحتوى بصفته مشاهدًا، أو جهاز غرفة متصل بمكالمة يتوفّر مرجع واحد conferenceRecords.participants لكل مستخدم. عندما ينضم مشارك إلى المكالمة، يتم تخصيص رقم تعريف فريد له.

جلسة المشارك

رقم تعريف جلسة فريد يتم إنشاؤه لكل زوج من المشاركين والأجهزة ينضم إلى مكالمة. يتوفّر مصدر واحد conferenceRecords.participants.participantSessions لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من جهاز المشارك نفسه، يتم منح كل مشارك معرّفات جلسة فريدة.