بدء استخدام 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.

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

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

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

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

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

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

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

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

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

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

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

• مفاهيم Meet Media API

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

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