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

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

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

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

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

تحتفظ 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 محدودة:

محدود: تمنح هذه النطاقات وصولاً واسع النطاق إلى بيانات مستخدمي 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.

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

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