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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عبارات عامة

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

العنصر
ملف تم إنشاؤه من خلال Meet استجابةً لأحد مؤتمرات، مثل التسجيلات وtranscripts. عادةً ما تكون العناصر جاهزة للاسترجاع بعد وقت قصير من انتهاء المؤتمر.
حدث في التقويم
حدث في "تقويم Google" يضم ضيوفًا متعددين، عادةً ما ينشئه منظِّم اجتماع ويحتوي على معلومات الانضمام إلى اجتماع. قد يكون تطبيق Meet هو حل المؤتمر المناسب للفعالية.
اتصال
جلسة باستخدام Meet، أو لإعلام المستخدمين الآخرين ببدء مكالمة أو بدء مكالمة، والسماح لهم بالانضمام على الفور.
مؤتمر
مؤتمر الفيديو هو مثال على مكالمة داخل مساحة اجتماعات. يعتبر المستخدمون عادةً هذا السيناريو اجتماعًا واحدًا.
المضيف المشارك
شخص في مكالمة تم منحه امتيازات إدارة المضيف من خلال مضيف، باستثناء إمكانية إزالة المضيف الأصلي.
المضيف
الشخص الذي أنشأ مكالمة (منظّم الاجتماع) أو الشخص الذي يتحكّم في المكالمة لاحظ أنه يمكن لمنظم الاجتماع تنظيم الاجتماع ولكنه لا يكون حاضرًا عند عقده. يمكن للمضيف أيضًا تفويض امتيازات المضيف إلى مضيف مشارك.
رمز الاجتماع
سلسلة فريدة من 10 أحرف يمكن كتابتها لمساحة اجتماع، ويتم استخدامها ضمن عنوان URL لانضمام المساحة إلى مساحة اجتماع. على سبيل المثال، abc-mnop-xyz. يجب عدم تخزين رموز الاجتماعات على المدى الطويل لأنه يمكن فصلها عن مساحة الاجتماع ويمكن إعادة استخدامها لمساحات الاجتماعات المختلفة في المستقبل. بشكل عام، تنتهي صلاحية رموز الاجتماعات بعد 365 يومًا من آخر استخدام. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التعرّف على رموز الاجتماعات في Google Meet.
اسم الاجتماع
معرّف فريد ينشئه الخادم يُستخدم لتحديد مساحة اجتماع. يتم عرض معرّف الاجتماع في الحقل name لمورد spaces.
منظّم الاجتماع
المستخدم الذي أنشأ مساحة الاجتماع يمكن أيضًا اعتبار هذا المستخدم مالك الاجتماع. قد لا يكون حاضرًا أثناء المكالمة أو يكون مضيف الاجتماع. يمكن أن يكون هناك منظِّم واحد فقط للاجتماع.
مساحة الاجتماع
مكان افتراضي أو عنصر دائم (مثل غرفة اجتماعات) لعقد مؤتمر يمكن عقد مؤتمر نشط واحد فقط في مساحة واحدة في أي وقت. تساعد مساحة الاجتماعات أيضًا المستخدمين على مقابلة الموارد المشترَكة والعثور عليها.
المشارك
شخص انضم إلى مكالمة أو كان يستخدم وضع المزاملة أو أثناء المشاهدة كمشاهد أو جهاز غرفة متصل بمكالمة. يتوفّر مورد conferenceRecords.participants واحد لكل شخص. عندما ينضم أحد المشاركين إلى المؤتمر، يتم تعيين معرّف فريد.
جلسة المشارك
معرّف جلسة فريد يتم إنشاؤه لكل زوج من أجهزة المشاركين ينضم إلى مكالمة. يتوفر مورد conferenceRecords.participants.participantSessions واحد لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من زوج جهاز المشارِك نفسه، سيتم تخصيص رقم تعريف فريد لكل جلسة.

معلومات المصادقة والمصادقة الخاصة بواجهة برمجة التطبيقات

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

تتوافق واجهة برمجة التطبيقات Meet REST مع نطاقات OAuth 2.0 التالية:

رمز النطاق الوصف الاستخدام
https://www.googleapis.com/auth/meetings.space.readonly يمكنك السماح للتطبيقات بقراءة البيانات الوصفية حول أي مساحة اجتماعات يمكن للمستخدم الوصول إليها. الفئات الحساسة
https://www.googleapis.com/auth/meetings.space.created السماح للتطبيقات بإنشاء وتعديل وقراءة البيانات الوصفية حول مساحات الاجتماعات التي أنشأها تطبيقك الفئات الحساسة
https://www.googleapis.com/auth/drive.readonly السماح للتطبيقات بتنزيل ملفات التسجيل والنصوص من Google Drive API. محظور

للحصول على مزيد من المعلومات حول نطاقات OAuth 2.0 المحددة، يُرجى الاطّلاع على نطاقات OAuth 2.0 لواجهات Google APIs.