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

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

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

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

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

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

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

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

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

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

في ما يلي بعض الأمثلة على الاستخدامات الممكنة لواجهة برمجة تطبيقات Meet REST:

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

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

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

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

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

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

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

عبارات عامة

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

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

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

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

اسم الاجتماع

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

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

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

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

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

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

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

المشارك

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

جلسة المشارك

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