بدء استخدام 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 التالية:

  • وقت الإرسال المطلق
  • Transport-Wide Congestion Control
  • وقت الالتقاط المطلق
  • وصف التبعية
  • مؤشر مستوى الصوت (urn:ietf:params:rtp-hdrext:ssrc-audio-level)

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

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

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

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

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

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

• في Google Cloud Console، فعِّل واجهة Google Meet REST API.

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

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

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

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

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

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

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

ملاحظة مهمة: يُرجى الاطّلاع على سياسة بيانات مستخدمي واجهات برمجة التطبيقات وسياسة المطوّرين في Workspace للحصول على تفاصيل حول الوصول المناسب إلى 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 والمتطلبات الإضافية لنطاقات واجهات برمجة التطبيقات المحدّدة. إذا كنت تخزّن بيانات النطاق المحدود على خوادم (أو تنقلها)، عليك اجتياز تقييم أمان.

إذا كان تطبيقك يتطلّب الوصول إلى أي واجهات برمجة تطبيقات أخرى من 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. على سبيل المثال، إذا كان المستخدمون النهائيون يستخدمون جهاز غرفة اجتماعات Cisco يعمل بنظام Meet، لن تتمكّن مثيل Meet Media API من الانضمام إلى المكالمة.

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

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

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

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

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

• التعرّف على مفاهيم Media API

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

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