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

معاينة مطوّري البرامج: تتوفّر هذه الميزة كجزء من برنامج برنامج الاستخدام المبكر في Google Workspace لمطوّري البرامج، الذي يمنح إمكانية الوصول المبكر إلى ميزات معيّنة.

لاستخدام Meet Media API للوصول إلى الوسائط في الوقت الفعلي من مؤتمر، يجب تسجيل مشروع Google Cloud والكيان الرئيسي لبروتوكول OAuth وجميع المشاركين في المؤتمر في برنامج معاينة مطوّري البرامج.

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

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

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

• يجب أن تتيح برامج العميل استخدام جميع برامج الترميز التالية:

  • AV1
  • VP9
  • VP8

• يجبأن تستخدم برامج العميل عمليات تنفيذ برامج الترميز المتوافقة مع متطلبات برنامج الترميز في Meet Media API، بما في ذلك:

  • libvpx (من Google) لفك ترميز VP8 أو VP9
  • dav1d (من VideoLAN) لفك ترميز AV1

• يجب أن تتيح برامج العميل استخدام إضافات عناوين WebRTC التالية:

  • وقت الإرسال المطلق
  • التحكّم في الازدحام على مستوى النقل
  • وقت التسجيل المطلق
  • واصف التبعية
  • مؤشر مستوى الصوت (urn:ietf:params:rtp-hdrext:ssrc-audio-level)

• يجب أن ترسل برامج العميل بشكل دوري الحزمة الكاملة من المقاييس. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة مقاييس العميل للحصول على التفاصيل.

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

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

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

تفعيل Meet REST API

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

• في Google Cloud Console، فعِّل Google Meet REST API.

  تفعيل واجهة برمجة التطبيقات

ملاحظة: الحدّ التلقائي لمعدّل الطلبات هو 6000 طلب في الدقيقة. إذا تجاوزت هذا الحدّ، ستتلقّى استجابة برمز حالة HTTP‏ RESOURCE_EXHAUSTED. إذا كنت بحاجة إلى زيادة الحدّ، يُرجى التواصل مع فريق دعم مطوّري Google Workspace. .

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

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

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

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

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

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

**ملاحظة مُهمة:** يُرجى الاطّلاع على سياسة المطوّرين وبيانات مستخدمي Workspace API للحصول على تفاصيل حول الوصول المناسب إلى Google Meet Media API.

نطاقات 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 محدودة:

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

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

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

إذا كان تطبيقك يتطلب الوصول إلى أي من Google APIs الأخرى، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات حول نطاقات 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	‫2025.05.30
iOS	تطبيق Gmail	6.0.250518

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

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

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

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

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

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

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

مواضيع ذات صلة

• مفاهيم Meet Media API

• مزيد من المعلومات عن المصادقة والتفويض

• طرق المصادقة في Google