بدء استخدام Meet Media API

لاستخدام Google Meet Media API ونطاقات OAuth 2.0 المرتبطة بها، يجب أن يلتزم تطبيقك بالمتطلبات التالية.

المتطلبات الفنية

يتم فرض القيود التالية عند استخدام Meet Media API:

للحصول على أفضل النتائج والدعم:

  • يجب أن تستخدم البرامج libwebrtc، وألا يكون الإصدار أقدم من 12 شهرًا من أحدث إصدار من STABLE Chromium. تستخدم متصفّحات Chromium libwebrtc لتنفيذ واجهات برمجة تطبيقات JavaScript الخاصة بـ WebRTC.

  • يجب أن يحافظ العملاء على معدل نقل بيانات لا يقل عن 4 ميغابت في الثانية.

تفعيل واجهة Meet REST API

قبل استخدام واجهات Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيق واحدة أو أكثر في مشروع واحد على Google Cloud.

سياسة الإيقاف النهائي لبرامج الترميز

  • تحتفظ Google بالحق في التوقف عن استخدام برنامج ترميز في أي وقت.

  • عند طرح برنامج ترميز جديد، سيتلقّى المطوّرون إشعارًا قبل 12 شهرًا من الموعد الذي يُطلب فيه من العملاء توفير الدعم لبرنامج الترميز هذا.

المصادقة والتفويض

تتصل برامج Google Meet Media API بمؤتمر نيابةً عن مستخدم معيّن، باستخدام OAuth 2.0 للمصادقة والتفويض.

إذن الوصول المناسب

نطاقات Meet Media API

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

تتيح واجهة Meet Media API استخدام نطاق OAuth 2.0 التالي:

رمز النطاق الوصف الاستخدام
https://www.googleapis.com/auth/meetings.conference.media.readonly تسجيل الفيديو والصوت في الوقت الفعلي خلال مكالمات الفيديو على Google Meet محظور
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly تسجيل صوت في الوقت الفعلي خلال مكالمات الفيديو على Google Meet محظور
https://www.googleapis.com/auth/meetings.conference.media.video.readonly تسجيل الفيديو في الوقت الفعلي أثناء مكالمات الفيديو على Google Meet محظور

نظرًا للطبيعة الحساسة للمؤتمرات، يتم حظر جميع نطاقات Meet Media API:

بالإضافة إلى نطاقات Meet Media API، يجب أيضًا طلب نطاق قراءة الاجتماع العام باستخدام OAuth. هذا النطاق مطلوب للوصول إلى البيانات الوصفية للاجتماع، مثل معلومات المشاركين وإدخال الوسائط، وللتفاوض على اتصال ناجح.

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

إذا كان تطبيقك يتطلّب الوصول إلى أي واجهات برمجة تطبيقات أخرى من Google، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات عن نطاقات Google API، يُرجى الاطّلاع على استخدام بروتوكول OAuth 2.0 للدخول إلى واجهات Google APIs.

لتحديد المعلومات التي يتم عرضها للمستخدمين ومراجعي التطبيقات، يُرجى الاطّلاع على ضبط شاشة موافقة OAuth واختيار النطاقات.

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

متطلبات المستخدم النهائي

لاستخدام Meet Media API، يجب أن يستوفي المشاركون في اجتماع Meet أيضًا بعض المتطلبات الدنيا ليكون الاجتماع مؤهلاً.

إصدارات تطبيقات الأجهزة الجوّالة

بالنسبة إلى مستخدمي الأجهزة الجوّالة، يجب تثبيت الإصدارات التالية:

النظام الأساسي تطبيق الإصدار
Android تطبيق Meet 309
iOS تطبيق Meet 308
Android تطبيق Gmail ‫30/05/2025
iOS تطبيق Gmail 6.0.250518

الأنظمة الأساسية غير المتوافقة

لا تتوافق أجهزة الجهات الخارجية التي تشغّل Meet مع Google. على سبيل المثال، إذا كان المستخدمون النهائيون يستخدمون جهاز غرفة اجتماعات من Cisco يعمل بنظام Meet، لن تتمكّن مثيل Meet Media API من الانضمام إلى المكالمة.

القيود على المراحل العمرية

يُحظر على Meet Media API جمع الوسائط من الحسابات المسجّلة للقاصرين.

وهي عادةً حسابات يقلّ عمر أصحابها عن سن الرشد في بلدانهم (عادةً أقل من 18 عامًا) أو كان عمرهم أقل من سن الرشد عندما أنشأ أحد الوالدَين الحساب في تطبيق Google Family Link.

يُرجى العِلم أنّ بعض المناطق (مثل الاتحاد الأوروبي) تفرض قيودًا إضافية على أنواع الحسابات التي تُصنّف على أنّها حسابات قاصرين.

إذا كنت تعتقد أنّ أحد حسابات المستخدمين مقيّد، يمكنك تقديم إثبات العمر للتحقّق مما إذا كان قد تم إثبات عمر حسابه. مزيد من المعلومات عن عملية إثبات عمرك