ملاحظات حول الإصدار

الإصدار	تاريخ الإصدار	ملاحظات
25.5.0	‫17‏/09‏/2026	تم رفع الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 24. تمّت إضافة "onInitializationFailed()" إلى "InitializationCompleteCallback". تُبلغ محوّلات التوسّط الآن عن أخطاء إعداد حِزم تطوير البرامج (SDK) التابعة لجهات خارجية إلى حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" باستخدام رمز الخطأ ونطاق الخطأ ورسالة الخطأ. عند استخدام ميزة التوسّط مع مصادر إعلانات الأحداث المخصّصة، يعرض ResponseInfo.getAdapterClassName() الآن اسم فئة الحدث المخصّص بدلاً من com.google.ads.mediation.customevent.CustomEventAdapter.
25.4.0	‫17‏/06‏/2026	تم إصلاح الأخطاء وإجراء تحسينات على الأداء.
25.3.0	‫21‏/05‏/2026	تمّت إضافة طريقة setAgeRestrictedTreatment() في RequestConfiguration.Builder وإيقاف setTagForChildDirectedTreatment() وsetTagForUnderAgeOfConsent() نهائيًا. استخدِم الطريقة الجديدة لضبط المعالجة المحظورة على فئات عمرية معيّنة للمستخدمين من الأطفال والمراهقين.
25.2.0	‫13/04/2026	تم إصلاح الأخطاء وإجراء تحسينات على الأداء.
25.1.0	‫16‏/03‏/2026	تم إصلاح خطأ في أداة فحص الإعلانات قد يؤدي إلى حدوث خطأ عند طلب إعلان اختباري خارج السياق يتضمّن عنوان URL فارغًا للمحتوى.
25.0.0	‫17‏/02‏/2026	هذا الإصدار هو تحديث رئيسي يتضمّن عدّة تغييرات قد تؤدي إلى عطل. يمكنك الاطّلاع على مقالة نقل البيانات إلى الإصدار 25 من حزمة SDK لمزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى عطل: تمت إزالة الفئة VersionInfo في الحزمة com.google.android.gms.ads.mediation. تمت إزالة طريقة getConfiguration() المتوقفة نهائيًا في فئة RtbSignalData. تمّت إزالة الدالتين onFailure(String) وonAdFailedToShow(String) اللتين تم إيقافهما نهائيًا في الفئات التالية: SignalCallbacks MediationAdLoadCallback MediationInterstitialAdCallback MediationRewardedAdCallback تمت إزالة الفئة NativeAdViewHolder من الحزمة com.google.android.gms.ads.nativead. تمت إزالة MIN_WIDTH_RATIO وMIN_HEIGHT_RATIO من MediationUtils لإتاحة حدود أكثر مرونة لمطابقة أحجام الإعلانات في التوسّط. تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 4.0.0. تمت إتاحة استخدام "إعلانات البانر التكيُّفية الثابتة" الكبيرة. تم تصميم "إعلانات البانر التكيُّفية الثابتة الكبيرة" لزيادة التفاعل والإيرادات. يمكنك طلب "إعلانات البانر التكيُّفية الثابتة" الكبيرة باستخدام الطرق التالية في فئة AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() تم إيقاف الطرق التالية في الفئة AdSize: getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int) getLandscapeAnchoredAdaptiveBannerAdSize(Context, int) getPortraitAnchoredAdaptiveBannerAdSize(Context, int)
24.9.0	‫11/12/2025	تم إصلاح الأخطاء وإجراء تحسينات على الأداء.
24.8.0	‫20/11/2025	تم إصلاح مشكلة عدم توفّر ترجمات لموارد حزمة SDK في الإصدارَين 24.6.0 و24.7.0. تم إيقاف NativeAdViewHolder نهائيًا. استخدِم NativeAdView لعرض "الإعلانات المدمجة مع المحتوى" بدلاً من ذلك. تم إيقاف الطريقتَين AdPreloader.getConfigurations() وAdPreloader.getConfiguration(preloadId) نهائيًا. ولا تتوفّر بدائل لهذه الطرق.
24.7.0	‫09‏/10‏/2025	تم تصحيح تعليق توضيحي مفقود يقبل القيمة الفارغة في نوع القيمة التي تم إرجاعها لـ NativeCustomFormatAd.getDisplayOpenMeasurement(). لم تتغيّر الوظيفة، لأنّ قدرة الطريقة على عرض قيمة فارغة كانت متوقّعة من قبل. تم الرجوع إلى إصدار سابق من تبعية androidx.webkit:webkit من 1.14.0 إلى 1.12.1 للحفاظ على التوافق مع الإصدار 7.3.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
24.6.0	‫08‏/09‏/2025	يمكن الآن لمحوّلات التوسّط في "الإعلانات المدمجة مع المحتوى" تنفيذ NativeAdMapper.destroy() لتلقّي إشعار عند إتلاف "إعلان مدمج مع المحتوى".
24.5.0	‫24‏/07‏/2025	يمكن الآن للناشرين الذين لديهم إمكانية الوصول إلى الميزة استخدام رقم تعريف موضع الإعلان لجميع أشكال الإعلانات. تم إصلاح عطل يتعلّق برسالة الخطأ Fatal Exception: java.util.ConcurrentModificationException.
24.4.0	‫09‏/06‏/2025	تمت إضافة العديد من واجهات برمجة التطبيقات الجديدة للتحميل المسبَق للإعلانات وإيقاف الواجهات الحالية نهائيًا. لا تزال ميزة "التحميل المسبَق للإعلان" في الإصدار الأوّلي المحدود.
24.3.0	‫19‏/05‏/2025	تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 3.2.0.
24.2.0	‫07‏/04‏/2025	تم إصلاح الأخطاء وإجراء تحسينات على الأداء.
24.1.0	‫12‏/03‏/2025	الحدّ الأدنى لإصدار Kotlin هو 2.1.0 الآن. تم إصلاح الأخطاء وإجراء تحسينات على الأداء. سيتم نقل play-services-ads-lite إلى وتيرة إصدارات منخفضة، ولن يتم توزيعه مع هذا الإصدار. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Lite SDK.
24.0.0	‫24‏/02‏/2025	هذا الإصدار هو تحديث رئيسي يتضمّن عدّة تغييرات قد تؤدي إلى عطل. يمكنك الاطّلاع على مقالة نقل البيانات إلى الإصدار 24 من حزمة تطوير البرامج (SDK) لمزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى عطل: تم رفع الحدّ الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 23. تمت إزالة جميع واجهات برمجة التطبيقات ذات الصلة بشكل "الإعلان البيني الذي يظهر أثناء التمرير". تمت إزالة واجهات برمجة التطبيقات القديمة الخاصة باتجاه AppOpenAd. تمت إزالة صفَّين (SearchAdView) وDynamicHeightSearchAdRequest صفوف. تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 3.1.0. أصبحت ميزة "تحسين الإعداد وتحميل الإعلانات" متوفرة للجمهور العام الآن، وهي مفعَّلة تلقائيًا. تمت إضافة MediationRewardedAdCallback.onUserEarnedReward() وإيقاف نهائي لـ MediationRewardedAdCallback.onUserEarnedReward(RewardItem). يجب تعديل محوّلات التوسّط لاستخدام الطريقة الجديدة. تمت إزالة علامة السمة android.adservices.AD_SERVICES_CONFIG من ملف بيان حزمة تطوير البرامج (SDK) لمنع حدوث تعارضات في الدمج للتطبيقات التي تضبط خدمات الإعلانات الخاصة بواجهة برمجة التطبيقات.
23.6.0	‫03‏/12/2024	تم إيقاف جميع واجهات برمجة التطبيقات ذات الصلة بشكل "الإعلان البيني الذي يظهر أثناء التمرير" نهائيًا. على سبيل المثال، AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0	‫29‏/10‏/2024	تم تعديل رسائل logcat الخاصة بتعذُّر تحميل الإعلانات التي تم تقديمها في الإصدار 23.4.0 من مستوى الخطأ إلى مستوى المعلومات. تحسين تحقيق الربح من الإعلانات المخصّصة في "علامات التبويب المخصّصة" في WebView API للإعلانات
23.4.0	‫30-09-2024	تؤدي حالات تعذُّر تحميل الإعلانات الآن إلى استدعاء رسالة logcat تتضمّن ad failed to load في تتبُّع تسلسل استدعاء الدوال البرمجية لحالة التعذُّر. ويسجّل تتبُّع تسلسل استدعاء الدوال البرمجية هذه الرسالة كخطأ، ولكن لا يعني ذلك حدوث عطل. راجِع تصحيح أخطاء رسائل تسجيل الأخطاء الشائعة لتفسير حالات تعذُّر تحميل الإعلانات الشائعة. إذا ظهر لك خطأ متكرّر مرتبط بعرض الإعلانات ولم يتم توثيقه، يُرجى مشاركة تتبُّع تسلسل استدعاء الدوال البرمجية مع فريق دعم Google Mobile Ads SDK (Legacy). تمت إضافة طرق addCustomTargeting() إلى AdRequest.
23.3.0	‫12‏/08‏/2024	تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 3.0.0.
23.2.0	‫27‏/06‏/2024	تمت إضافة AdView.isCollapsible() للإشارة إلى ما إذا كان آخر إعلان بانر تم تحميله قابلاً للتصغير.
23.1.0	‫09‏/05‏/2024	يتطلّب الإصدار 34 من compileSdkVersion كحدّ أدنى. محوّلات التوسّط في الإعلانات المدمجة مع المحتوى: تم إيقاف loadNativeAd وloadRtbNativeAd() نهائيًا لصالح loadNativeAdMapper() وloadRtbNativeAdMapper(). يجب أن تنتقل المحوّلات إلى استخدام طرق التحميل الجديدة هذه والعناصر ذات الصلة.
23.0.0	‫07-03-2024	هذا الإصدار هو تحديث رئيسي يتضمّن عدّة تغييرات قد تؤدي إلى عطل. يمكنك الاطّلاع على مقالة نقل البيانات إلى الإصدار 23 من حزمة SDK لمزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى عطل: تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 21. لمواصلة جمع مقاييس سلوك المستخدمين في AdMob، يجب ربط تطبيقك على AdMob بمنصّة Firebase ودمج حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقك. تمت إزالة واجهة برمجة التطبيقات MobileAds.enableSameAppKey() المتوقفة نهائيًا وتعديل الطريقة البديلة MobileAds.putPublisherFirstPartyIdEnabled() لعرض قيمة منطقية حول ما إذا كان الاحتفاظ بعناصر التحكّم ناجحًا أم لا. ‫Native Ads: تمت إزالة AdLoader.forUnifiedNativeAd(). يمكنك استخدام AdLoader.forNativeAd() كبديل. تمت إزالة AdLoader.forCustomTemplateAd(). يمكنك استخدام AdLoader.forCustomFormatAd() كبديل. تمت إزالة AdFormat.UNKNOWN بدون استبدال. يجب أن تمرّر التطبيقات التي تستخدم QueryInfo.generate() شكل إعلان. يمكن الآن ربط طرق AdManagerAdRequest.Builder المكتسبة من العنصر الرئيسي معًا لإنشاء عنصر من مكالمة واحدة. تطلّب ذلك تغييرًا في بنية التوريث بحيث لا يرث AdManagerAdRequest.Builder من AdRequest.Builder. تضيف MobileAds.registerCustomTabsSession() لتحسين تحقيق الربح من الإعلانات في "علامات التبويب المخصّصة". لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحسين علامات التبويب المخصّصة. تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 2.2.0.
22.6.0	‫06‏/12‏/2023	تم إيقاف MobileAds.setSameAppKeyEnabled() نهائيًا وتمت إعادة تسمية الطريقة إلى MobileAds.putPublisherFirstPartyIdEnabled(). تم إيقاف AdFormat.UNKNOWN نهائيًا بدون بديل. يجب أن تمرّر التطبيقات التي تستخدم QueryInfo.generate() شكل إعلان.
22.5.0	‫30‏/10‏/2023	تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 2.1.0. تمت إضافة الطريقة setPublisherPrivacyPersonalizationState() إلى Publisher Privacy Treatment API (إصدار تجريبي).
22.4.0	‫13‏/09‏/2023	يجب أن يكون الحد الأدنى لـ compileSdkVersion هو 33. أداة فحص الإعلانات: تمت إضافة دعم حزمة تطوير البرامج (SDK) لطلب الإعلانات وعرضها من خلال واجهة مستخدم "أداة فحص الإعلانات". تمت إضافة طريقة QueryInfo.generate() جديدة تستخدم معرّف الوحدة الإعلانية. تتيح هذه الميزة الاختبار الأوّلي للإصدار التجريبي من Attribution Reporting والإصدار التجريبي من Topics واجهات برمجة التطبيقات المخصّصة للحفاظ على الخصوصية. لمزيد من المعلومات، يُرجى الاطّلاع على دليل "مبادرة حماية الخصوصية" على Android في AdMob.
22.3.0	‫22‏/08‏/2023	تمت إضافة إمكانية إنشاء أحجام تكيُّفية باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كان يتم التعامل مع أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH على أنّها AdSize.SMART_BANNER.
22.2.0	‫05‏/07‏/2023	الأحداث المخصّصة: تم إيقاف AdRequest.Builder.addCustomEventExtrasBundle() نهائيًا. مدِّد Adapter وتفاعَل مع المَعلمات الإضافية من خلال AdRequest.Builder.addNetworkExtrasBundle() بدلاً من ذلك. تم إيقاف AdRequest.getCustomEventExtrasBundle() نهائيًا. مدِّد Adapter وتفاعَل مع المَعلمات الإضافية من خلال AdRequest.getNetworkExtrasBundle() بدلاً من ذلك.
22.1.0	‫18‏/05‏/2023	أداة فحص الإعلانات: تم تفعيل إمكانية إرسال طلبات عرض الإعلانات من واجهة مستخدم "أداة فحص الإعلانات" على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0	‫29‏/03‏/2023	هذا الإصدار هو تحديث رئيسي يتضمّن عدّة تغييرات قد تؤدي إلى عطل. يمكنك الاطّلاع على مقالة نقل البيانات إلى الإصدار 22 من حزمة تطوير البرامج (SDK) لمزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى عطل: تمّت إزالة NativeCustomFormatAd.getVideoController() وNativeCustomFormatAd.getVideoMediaView() واستخدام NativeCustomFormatAd.getMediaContent() بدلاً منهما. تمّت إزالة MobileAds.getVersionString() واستخدام MobileAds.getVersion() بدلاً منه. تمّت إزالة AdRequest.Builder.setAdInfo() واستخدام AdRequest.Builder.setAdString() بدلاً منه. تعرض الدالة AdManager.Builder.setAdString() الآن نوع AdRequest.Builder. تمّت إزالة MediationRewardedVideoAdAdapter وواجهات برمجة التطبيقات المرتبطة به واستخدام Adapter بدلاً منه. تمت إضافة AdRequest.getRequestAgent(). التوسّط: تم تغيير القيمة المعروضة لكل من Adapter.getVersionInfo() و Adapter.getSDKVersionInfo() من النوع com.google.android.gms.ads.mediation.VersionInfo إلى com.google.android.gms.ads.VersionInfo. ننصح بأن تعرض المحوّلات النوع الجديد لأنّ com.google.android.gms.ads.mediation.VersionInfo متوقّف نهائيًا.
21.5.0	‫31-01-2023	الإعلانات على شاشة فتح التطبيق: تم إيقاف AppOpenAd.load() الطرق التي تقبل مَعلمة إدخال الاتجاه نهائيًا، وتمت إضافة طرق جديدة لا تقبل إدخال الاتجاه. تحدّد الطرق الجديدة الاتجاه في وقت الطلب، بما يتوافق مع سلوك أشكال الإعلانات الأخرى بملء الشاشة. التوسّط: تمت إضافة ميزة التوسّط لـ "الإعلانات على شاشة فتح التطبيق". تمت إزالة الإذن RECEIVE_BOOT_COMPLETED من التبعية androidx.work:work-runtime. إذا كنت تستخدم إصدارات Gradle أقدم من 7.2.0 وتحتاج إلى إذن لتطبيقك، قد تحتاج إلى الإعلان عن الإذن صراحةً في ملف بيان Android.
21.4.0	‫14‏/12‏/2022	أصبح رقم تعريف تطبيق "مدير إعلانات Google" مطلوبًا الآن لجميع تطبيقات "مدير إعلانات Google"، ويجب أن يكون بالتنسيق ca-app-pub-################~##########. يُرجى الاطّلاع على ضبط تطبيقك لمزيد من التفاصيل. أداة فحص الإعلانات: تم توسيع نطاق دعم حزمة تطوير البرامج (SDK) لعرض إعلانات البانر و"الإعلانات المدمجة مع المحتوى" التي يتم طلبها من خلال واجهة مستخدم "أداة فحص الإعلانات". تمت إضافة ميزة "معرّف الطرف الأول الخاص بالناشر" (المعروفة سابقًا باسم "مفتاح التطبيق نفسه") لمساعدتك في عرض إعلانات أكثر صلةً وتخصيصًا باستخدام البيانات التي يتم جمعها من تطبيقاتك. نسخة الإصدار الرسمية للجيل QueryInfo
21.3.0	‫10‏/10‏/2022	أداة فحص الإعلانات: تمت إضافة دعم حزمة تطوير البرامج (SDK) لطلب الإعلانات وعرضها من خلال واجهة مستخدم "أداة فحص الإعلانات". الإعلانات المدمجة مع المحتوى: تمّت إضافة "getMediaContent()" إلى "MediaView". الإعلانات المخصّصة المدمجة مع المحتوى: تمّت إضافة "getMediaContent()" إلى "NativeCustomFormatAd". تم إيقاف getVideoMediaView() نهائيًا. يمكنك إنشاء MediaView خاص بك واستخدام NativeCustomFormatAd.getMediaContent() بدلاً من ذلك. تم إيقاف getVideoController() نهائيًا. يمكنك استخدام NativeCustomFormatAd.getMediaContent().getVideoController() كبديل.
21.2.0	‫06‏/09‏/2022	أداة فحص الإعلانات: تمت إضافة دعم حزمة تطوير البرامج (SDK) لتصدير سجلّات طلبات عرض الإعلانات من خلال قائمة مشاركة البيانات من Android.
21.1.0	‫14‏/07‏/2022	تمت إضافة ميزة تحقيق الربح من الإعلانات ضمن WebView. لمزيد من التفاصيل، يمكنك الاطّلاع على مقالة دمج WebView API للإعلانات. تمت إضافة getResponseExtras() إلى ResponseInfo ما قد يؤدي إلى عرض معلومات إضافية عن استجابة الإعلان. إصدار تجريبي: تتوفّر واجهة برمجة التطبيقات getResponseExtras() كإصدار تجريبي. قد تتغيّر القيمة المعروضة بدون إصدار حزمة SDK.
21.0.0	‫25‏/05‏/2022	هذا الإصدار هو تحديث رقم الإصدار الرئيسي يتضمّن عدة تغييرات قد تؤدي إلى عطل. يمكنك الاطّلاع على دليل نقل البيانات إلى الإصدار 21 من حزمة تطوير البرامج (SDK) للحصول على مزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى عطل: يتطلّب تطبيق "Google Mobile Ads SDK (Legacy)" الآن أن تكون جميع التطبيقات على الأقل في المستوى 19 من واجهة برمجة تطبيقات Android لكي تعمل. تمّت إضافة تعليقات توضيحية @NonNull في كل طريقة لم تحدّد سابقًا بشكل صريح إمكانية قبول القيمة الفارغة. تمت إزالة طريقة واحدة (AdRequest.Builder.addNetworkExtras()). يمكنك استخدام AdRequest.Builder.addNetworkExtrasBundle() كبديل. تمت إزالة طرق تحديد الموقع الجغرافي التالية: setLocation() في AdRequest.Builder ‫"getLocation()" على "AdRequest" getLocation() في MediationAdConfiguration تمت إضافة علامات البيان لتحسين عملية الإعداد وتحميل الإعلانات. يُرجى الاطّلاع على دليل تحسين عملية الإعداد وتحميل الإعلانات لمزيد من التفاصيل. تم إيقاف MobileAds.getVersionString() نهائيًا. استخدِم MobileAds.getVersion() بدلاً من ذلك. تمت إضافة طريقة getLoadedAdapterResponseInfo() في ResponseInfo. تمت إضافة الطرق التالية في AdapterResponseInfo: getAdSourceName() getAdSourceId() getAdSourceInstanceName() getAdSourceInstanceId() إصدار تجريبي: واجهات برمجة التطبيقات هذه في إصدار تجريبي. وقد تتغيّر القيم المعروضة بدون طرح إصدار جديد من حزمة تطوير البرامج (SDK). تمت إضافة إمكانية استخدام الأحداث المخصّصة في "أداة فحص الإعلانات".
20.6.0	‫22‏/02‏/2022	تم إيقاف جميع واجهات الأحداث المخصّصة نهائيًا. استخدِم الفئة Adapter والواجهة MediationAdLoadCallback بدلاً من ذلك. تمت إضافة إمكانية استخدام SharedPreferences gad_has_consent_for_cookies. ستفعّل السمة Google Mobile Ads SDK (Legacy) الإعلانات المحدودة (LTD) عند ضبط الإعداد المفضّل gad_has_consent_for_cookies على 0. لمزيد من التفاصيل، يُرجى الاطّلاع على إعداد الموافقة على ملفات تعريف الارتباط. Google Mobile Ads SDK (Legacy) سيتم إيقاف إرسال المعرّف الإعلاني على Android (AAID) عند استدعاء RequestConfiguration.Builder.setTagForChildDirectedTreatment() باستخدام TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE (راجِع الإعدادات المخصّصة للأطفال)، أو عند استدعاء RequestConfiguration.Builder.setTagForUnderAgeOfConsent() باستخدام TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE (راجِع إعدادات المستخدمين دون سن الرشد).
20.5.0	‫18‏/11‏/2021	تمت إضافة إمكانية استخدام أجهزة Android 12 للتطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات. تمت إضافة إمكانية استخدام معرِّف مجموعة التطبيقات لحالات الاستخدام، مثل إعداد التقارير ومنع الاحتيال.
20.4.0	‫22-09-2021	يتطلّب هذا الإصدار وجميع الإصدارات السابقة تبعية صريحة على androidx.work:work-runtime:2.7.0 لإصلاح خطأ يتسبب في تعطُّل التطبيق على Android S مع تتبُّع تسلسل استدعاء الدوال البرمجية التالي: Fatal Exception: java.lang.IllegalArgumentException: com.mycompany.myapp: Targeting S+ (version 10000 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent. Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles. at android.app.PendingIntent.checkFlags(PendingIntent.java:386) at android.app.PendingIntent.getBroadcastAsUser(PendingIntent.java:657) at android.app.PendingIntent.getBroadcast(PendingIntent.java:644) at androidx.work.impl.utils.ForceStopRunnable.getPendingIntent(ForceStopRunnable.java:174) at androidx.work.impl.utils.ForceStopRunnable.isForceStopped(ForceStopRunnable.java:108) at androidx.work.impl.utils.ForceStopRunnable.run(ForceStopRunnable.java:86) at androidx.work.impl.utils.SerialExecutor$Task.run(SerialExecutor.java:75) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641) at java.lang.Thread.run(Thread.java:920) لإصلاح هذا الخطأ، أضِف التبعيات التالية لـ Google Mobile Ads SDK (Legacy) إلى ملف Gradle على مستوى التطبيق في الوحدة: dependencies { implementation 'com.google.android.gms:play-services-ads:20.4.0' // For apps targeting Android 12, add WorkManager dependency. constraints { implementation('androidx.work:work-runtime:2.7.0') { because '''androidx.work:work-runtime:2.1.0 pulled from play-services-ads has a bug using PendingIntent without FLAG_IMMUTABLE or FLAG_MUTABLE and will fail in Apps targeting S+.''' } } } اعتبارًا من الإصدار 20.4.0، تتضمّن حزمة Google Mobile Ads SDK (Legacy) الإذن com.google.android.gms.permission.AD_ID في بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال أدوات إصدار Android. لمزيد من المعلومات عن بيان الأذونات AD_ID، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة المساعدة هذه في مركز مساعدة Play Console. تمت إضافة دالة الاستدعاء onAdClicked() إلى FullScreenContentCallback. تم تفعيل دالة الاستدعاء onAdClicked() في فئة AdListener لشكل "الإعلانات المدمجة مع المحتوى".
20.3.0	‫23‏/08‏/2021	تم إيقاف طريقة AdRequest.Builder.addNetworkExtras() نهائيًا. استخدِم AdRequest.Builder.addNetworkExtrasBundle() بدلاً من ذلك. الإعلانات المدمجة مع المحتوى: AdLoader.Builder.forCustomFormatAd() يقبل الآن OnCustomClickListener يمكن أن يكون فارغًا. محوّلات التوسّط: تم إصلاح التعليق التوضيحي الخاص بإمكانية قبول القيم الفارغة للمَعلمة mediationExtras في جميع طلبات تحميل محوّلات التوسّط.
20.2.0	‫08‏/06‏/2021	تمت إضافة ميزة "أداة فحص الإعلانات" (إصدار تجريبي) للناشرين في "مدير إعلانات Google".
20.1.0	‫29-04-2021	إعلان البانر التكيُّفي: تمت إضافة AdSize.getInlineAdaptiveBannerAdSize() لطلب "إعلانات البانر التكيُّفية المضمّنة" ذات الارتفاع الأقصى. تمت إضافة AdError.toString() لتسهيل عملية التسجيل.
20.0.0	‫05-04-2021	هذا الإصدار هو تحديث رقم الإصدار الرئيسي يتضمّن عدة تغييرات قد تؤدي إلى عطل. يُرجى الاطّلاع على دليل الاستعداد للإصدار 20 من حزمة SDK لمزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى عطل: تمت إزالة واجهة برمجة التطبيقات القديمة Interstitial. تمت إزالة واجهة برمجة التطبيقات القديمة RewardedVideoAd. تمت إزالة الفئات التي تبدأ بـ Publisher (مثلاً: PublisherAdView). تمت إزالة CustomRenderedAd. تمت إزالة InstreamAd. تمت إزالة SearchAdRequest. تمت إزالة AdListener.onAdLeftApplication(). تمت إزالة NativeAppInstallAd وNativeContentAd وUnifiedNativeAd. يتوفّر الآن شكل إعلان مدمج مع المحتوى واحد باسم NativeAd. RewardedAd أصبحت الآن فئة مجرّدة. استخدِم الإجراء الثابت RewardedAd.load() لتحميل إعلان مقابل مكافأة. تمّت إضافة أداة فحص الإعلانات (إصدار تجريبي). تم إيقاف AdSize.SMART_BANNER نهائيًا واستبدالها بإعلانات البانر التكيُّفية. تمّت إضافة تعليقات توضيحية صريحة حول إمكانية قبول القيم الفارغة في جميع واجهات برمجة التطبيقات العلنية.
19.8.0	‫15‏/03‏/2021	تمت إضافة تبعية على حزمة User Messaging Platform SDK. تمت إضافة دالة الاستدعاء onAdImpression() إلى FullScreenContentCallback. تم إيقاف تنسيق InstreamAd نهائيًا. محوّلات التوسّط: تم إيقاف MediationBannerAdapter وMediationInterstitialAdapter وMediationNativeAdapter نهائيًا. يجب أن تنفّذ المحوّلات الجديدة فئة Adapter لتحميل هذه الأشكال. ملاحظة: لن تتم إزالة فئات محوّلات التوسّط المتوقفة نهائيًا هذه في الإصدار 20.0.0 من أجل منح محوّلات التوسّط وقتًا للانتقال إلى واجهة برمجة التطبيقات الجديدة. يمكن الآن لمحوّلات عروض الأسعار تنفيذ طرق تحميل مختلفة في فئة Adapter للأشكال المخصّصة لعروض الأسعار في الوقت الفعلي.
19.7.0	‫20/01/2021	التغييرات الرئيسية في: InterstitialAd RewardedAd NativeAd AppOpenAd تم إيقاف CustomRenderedAd نهائيًا. تم إيقاف الفئات والحزم التي تبدأ بالبادئة Publisher واستبدالها بالبادئة AdManager. آخر إصدار ثانوي قبل الإصدار 20.0.0. ستتم إزالة جميع واجهات برمجة التطبيقات التي تم وضع علامة عليها بأنّها متوقفة نهائيًا في هذا الإصدار والإصدارات السابقة في الإصدار 20.0.0. يُرجى الاطّلاع على دليل نقل البيانات للإصدار 20.0.0 لمزيد من التفاصيل.
19.6.0	‫04‏/12‏/2020	تم إيقاف طريقة onAdLeftApplication() AdListener نهائيًا. تم إصلاح خطأ يطلب من المستخدمين على أجهزة Android 11 اختيار متصفّح عند النقر على إعلان.
19.5.0	‫20/10/2020	إعلانات البانر: يتم الآن استدعاء طريقة onAdImpression() AdListener لإعلانات البانر. تمت إضافة الطريقة setHttpTimeoutMillis() لتخصيص مهلة طلبات HTTPS التي يتم إجراؤها من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
19.4.0	‫10-09-2020	تمت إضافة إمكانية استخدام أجهزة Android 11 للتطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات. الإعلانات على شاشة فتح التطبيق: تم تغيير شكل AppOpenAd ليعمل بشكل أكبر كشكل إعلان بملء الشاشة بدلاً من عرض إعلان بانر. تمت إضافة الطريقتَين getResponseInfo() وshow() إلى AppOpenAd. تم إيقاف الفئتين AppOpenAdView وAppOpenAdPresentationCallback نهائيًا. التوسّط: تتوفّر الآن تقارير حالة التوسّط. استخدِم ResponseInfo.getAdapterResponses() للحصول على معلومات الاستجابة لكل شبكة إعلانات شاركت في طلب إعلان. الإعلانات القديمة مقابل مكافأة: تم إيقاف الإصدار RewardedVideoAd نهائيًا. تم إصلاح خلل يتسبب في استدعاء MobileAds.initialize() لمعالج الإكمال مرة واحدة فقط. يؤدي كل طلب إلى MobileAds.initialize() الآن إلى استدعاء دالة رد الاتصال عند الاكتمال.
19.3.0	‫20/07/2020	تنبيه: لا تتوافق الإصدارات 19.3.0 والإصدارات الأقدم من حزمة تطوير البرامج (SDK) مع الإصدار 11 من نظام التشغيل Android (المستوى 30 من واجهة برمجة التطبيقات). ننصحك باستخدام الإصدار 19.4.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) إذا كنت تخطّط لضبط targetSdkVersion على المستوى 30 من واجهة برمجة التطبيقات. تمت إضافة الطريقتَين getDomain() وgetCause() إلى AdError. تمت إضافة دوال استدعاء جديدة لتعذُّر التحميل إلى جميع أشكال الإعلانات التي تعرض LoadAdError. مثال: onAdFailedToLoad(LoadAdError). تم إيقاف دوال الاستدعاء المتعلّقة بتعذُّر التحميل نهائيًا والتي تعرض عددًا صحيحًا، على سبيل المثال: onAdFailedToLoad(int). الإعلانات مقابل مكافأة: تمت إضافة onRewardedAdFailedToShow(AdError) وتم إيقاف onRewardedAdFailedToShow(int) نهائيًا. توسّط الإعلانات التي تضم مكافآت: تمت إضافة رمز الخطأ MEDIATION_SHOW_ERROR الخاص بالعرض. جميع أخطاء العرض المتعلقة بالإعلانات المعروضة من خلال التوسّط تُرجع الآن MEDIATION_SHOW_ERROR لـ AdError.getCode() وNonNull AdError.getCause() يمثّل خطأ التوسّط الأساسي.
19.2.0	‫18‏/06‏/2020	تمت إضافة التنسيق RewardedInterstitialAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب الوصول. الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم "أداة التحقّق من الإعلانات المدمجة مع المحتوى" في طلبات الاختبار لمساعدتك في رصد انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها. تمت إضافة الطريقة MobileAds.disableMediationAdapterInitialization(). يجب استدعاء هذا الإجراء قبل إعداد Google Mobile Ads SDK (Legacy) لإيقاف إعداد محوِّل التوسّط. تحذير: قد يؤثر استدعاء هذه الطريقة سلبًا في أداء ميزة "توسّط Google". يجب عدم استدعاء هذه الطريقة إلا إذا كنت تُضمِّن محوّلات التوسّط من Google في تطبيقك ولكنك لا تستخدم التوسّط من خلال Google أثناء جلسة تطبيق معيّنة (على سبيل المثال، إذا كنت تُجري اختبار توسّط أ/ب).
19.1.0	‫16-04-2020	تم إيقاف MobileAds.initialize(Context, String) نهائيًا واستبداله بـ MobileAds.initialize(Context, OnInitializationCompleteListener). AdRequest.isTestDevice() تعرض الآن true للأجهزة الاختبارية التي تم ضبطها من خلال MobileAds.setRequestConfiguration(). تم إصلاح عطل NullPointerException في MobileAds.initialize() الذي حدث على بعض الأجهزة في التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) البسيطة.
19.0.1	‫18‏/03‏/2020	الإعلانات المدمجة مع المحتوى: تم إصلاح مشكلة تسرُّب الذاكرة التي كانت تحدث عند استخدام NativeCustomTemplateAd.
19.0.0	‫02‏/03‏/2020	هذا الإصدار هو تحديث رقم الإصدار الرئيسي يتضمّن التغييرات التالية التي قد تؤدي إلى عطل: تم تحديث الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى المستوى 16 من واجهة برمجة التطبيقات ليتوافق مع سياسة توزيع "خدمات Google Play". الإعلانات المدمجة مع المحتوى: تم نقل MediaContent إلى حزمة com.google.android.gms.ads. تمت إضافة إمكانية قراءة مَعلمات الموافقة من الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB وسلسلة us_privacy الصادرة عن مكتب IAB. تمّت إضافة setNeighboringContentUrls() وgetNeighboringContentUrls() إلى AdRequest. تمت إضافة الفئة ResponseInfo التي توفّر معلومات عن إعلان تم تحميله. بالنسبة إلى جميع أشكال الإعلانات، تم إيقاف getMediationAdapterClassName() نهائيًا لصالح getResponseInfo(). الإعلانات المدمجة مع المحتوى: تمت إضافة الطريقتَين getDuration() وgetCurrentTime() إلى MediaContent. التوسّط في الإعلانات المدمجة مع المحتوى: تمت إضافة الطريقتَين getDuration() وgetCurrentTime() إلى UnifiedNativeAdMapper لكي يتمكّن المحوّلون من تنفيذهما. تمّت إزالة AdRequest.Builder.addTestDevice(). استخدِم RequestConfiguration.Builder.setTestDeviceIds() بدلاً من ذلك.
18.3.0	‫05‏/11‏/2019	تمّت إضافة واجهات برمجة تطبيقات لشكل الإعلان "InstreamAd". تتوفّر هذه الميزة في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب الوصول. إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في الفئة AdSize. على سبيل المثال، تم تغيير اسم AdSize.getCurrentOrientationBannerAdSizeWithWidth() إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(). التوسّط: يرصد الإصدار Google Mobile Ads SDK (Legacy) الآن الاستثناءات التي تطرحها محوّلات التوسّط. توسّط الإعلانات مقابل مكافأة: تم إصلاح خلل كان يؤدي إلى عرض إعلان واحد فقط في حال تخزين عدة إعلانات مقابل مكافأة في ذاكرة التخزين المؤقت. تمت إضافة طريقة setTestDeviceIds() لتفعيل إعداد الأجهزة الاختبارية مرة واحدة لجميع طلبات عرض الإعلانات.
18.2.0	‫29-08-2019	تمّت إضافة واجهات برمجة تطبيقات لتنسيق AppOpenAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب الوصول.
18.1.1	‫23‏/07‏/2019	التوسّط: تتم الآن تهيئة المحوّلات عندما تطلب التطبيقات MobileAds.initialize(Context, OnInitializationCompleteListener). التوسّط: يتم الآن رصد ومعالجة الاستثناءات في المحوّلات التي تتضمّن تتبُّع تسلسل استدعاء الدوال البرمجية Google Mobile Ads SDK (Legacy) من خلال Google Mobile Ads SDK (Legacy).
18.1.0	‫09‏/07‏/2019	الإصدار الرسمي لإتاحة قياس بيانات التطبيق يتم تلقائيًا إعداد قياس بيانات التطبيق وإرسال البيانات عند بدء تشغيل التطبيق. تمت إضافة خيار تأخير قياس بيانات التطبيق إلى أن يتم استدعاء Google Mobile Ads SDK (Legacy) بشكل صريح. تمت إضافة طريقة إعداد جديدة، وهي MobileAds.initialize(Context, OnInitializationCompleteListener)، تُعلمك عند اكتمال إعداد Google Mobile Ads SDK (Legacy) وجميع محوّلات التوسّط التي تم ضبطها. تمت إضافة MobileAds.getInitializationStatus() لتوفير حالة الإعداد لجميع شبكات الإعلانات التي تم ضبطها لتطبيقك. تمت إضافة MobileAds.getRequestConfiguration(). يتم استخدام مَعلمات الاستهداف المحدّدة في عنصر الإعداد هذا لجميع طلبات عرض الإعلانات. الإعلانات المدمجة مع المحتوى: تمت إضافة طريقة NativeAdOptions.Builder.setMediaAspectRatio() لطلب نسبة عرض إلى ارتفاع محدّدة لملف الوسائط في "الإعلان المدمج مع المحتوى". يحلّ هذا الخيار محلّ الإجراء setImageOrientation() الذي تم إيقافه نهائيًا. الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير المخصّصة للفيديو، يمكن الآن ضبط نوع مقياس الصورة في MediaView باستخدام MediaView.setImageScaleType(). الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent(). يمكن الآن للناشرين الذين يحمّلون الصور باستخدام عناوين URL فقط الحصول على محتوى الوسائط الخاص بالإعلان، وتوفير صورة له، واستدعاء MediaView.setMediaContent() لتعبئة بيانات الصورة من خلال MediaView للإعلانات غير المخصّصة للفيديو. توسّط الإعلانات المدمجة مع المحتوى: يمكن الآن للمحوّلات توفير نسبة العرض إلى الارتفاع باستخدام UnifiedNativeAdMapper.setMediaContentAspectRatio(). تمت إضافة تبعيات على play-services-measurement وplay-services-measurement-sdk. لم تعد التطبيقات بحاجة إلى إضافة هذه التبعيات بشكل صريح.
18.0.0	‫17‏/06‏/2019	الانتقال من مكتبات دعم Android إلى مكتبات Jetpack (AndroidX) لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار "خدمات Google Play". لتجنُّب حدوث تعطُّل عند تشغيل التطبيق لأول مرة بعد تثبيته من "متجر Google Play"، يتطلّب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في ملف build.gradle: com.google.android.gms:play-services-measurement:17.0.0 com.google.android.gms:play-services-measurement-sdk:17.0.0 ملاحظة: هذا الإصدار هو تحديث رقم الإصدار الرئيسي وتغيير قد يؤدي إلى عطل.
17.2.1	‫21‏/05‏/2019	تم إصلاح خطأ ANR الذي حدث في android.media.AudioManager.getStreamVolume.
17.2.0	‫11‏/03‏/2019	إعلانات الفيديو مقابل مكافأة: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات للإعلانات مقابل مكافأة (اطّلِع على حزمة الإعلانات مقابل مكافأة ) التي تتيح لك تحميل إعلانات متعددة مقابل مكافأة في الوقت نفسه. التوسّط: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات لمحوّلات التوسّط التي تتيح إجراء الإعداد الأولي. تنفّذ المحوّلات التي تستخدم واجهة برمجة التطبيقات الجديدة فئة Adapter. على الناشرين الذين يستخدمون firebase-analytics مع الإصدار 17.2.0 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.2.0) استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.3	‫31-01-2019	على الناشرين الذين يستخدمون firebase-analytics مع الإصدار 17.1.3 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.1.3) استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.2	‫03‏/12‏/2018	على الناشرين الذين يستخدمون firebase-analytics مع الإصدار 17.1.2 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.1.2) استخدام com.google.firebase:firebase-analytics:16.0.6.
17.1.1	‫12‏/11‏/2018	تم إصلاح خطأ حيث كانت بعض مجموعات play-services-ads وfirebase-analytics (مثل ads:17.1.0 وanalytics:16.0.5) تؤدي إلى حدوث خطأ في برنامج تجميع duplicate entry. على الناشرين الذين يستخدمون firebase-analytics مع الإصدار 17.1.1 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.1.1) استخدام com.google.firebase:firebase-analytics:16.0.5.
17.1.0	‫02‏/11‏/2018	تمت إضافة الطريقتَين setMaxAdContentRating() وsetTagForUnderAgeOfConsent() إلى AdRequest.Builder. تمت إضافة الثوابت التالية لاستخدامها مع AdRequest.Builder.setMaxAdContentRating() وAdRequest.Builder.setTagForUnderAgeOfConsent(): MAX_AD_CONTENT_RATING_G MAX_AD_CONTENT_RATING_PG MAX_AD_CONTENT_RATING_T MAX_AD_CONTENT_RATING_MA TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
17.0.0	‫05‏/10‏/2018	على الناشرين في Google AdMob تحديد علامة <meta-data> مع المفتاح com.google.android.gms.ads.APPLICATION_ID في ملف AndroidManifest.xml. يُرجى الرجوع إلى دليل البدء لمزيد من التفاصيل. الإعلانات المدمجة مع المحتوى: تم إيقاف NativeAppInstallAd وNativeContentAd وواجهات برمجة التطبيقات المرتبطة بهما نهائيًا واستبدالها بـ UnifiedNativeAd. يُرجى الرجوع إلى الإعلانات المدمجة مع المحتوى المتقدّمة الموحّدة للحصول على مزيد من التعليمات حول استخدام واجهات برمجة التطبيقات الجديدة. الإعلانات المدمجة مع المحتوى: تمت إضافة ميزة "إيقاف هذا الإعلان". الإعلانات المدمجة مع المحتوى: تمت إزالة سجلّ التحذير غير الضار: "يجب ألا تكون قيمة UnconfirmedClickListener فارغة أثناء ضبط ClickConfirmingView". الإعلانات مقابل مكافأة: تمت إضافة طريقة setAdMetadataListener في RewardedVideoAd للاستماع إلى تغييرات البيانات الوصفية للإعلانات. الإعلانات مقابل مكافأة: سيؤدي استدعاء destroy() إلى إلغاء المستمع. تم إيقاف الطرق التالية نهائيًا في AdRequest.Builder. setGender() setBirthday() setIsDesignedForFamiles() تم إصلاح خطأ كان يتسبب في عدم تشغيل onRewardedVideoCompleted() على المحاكيات.
16.0.0	‫02‏/10‏/2018	ما مِن تغييرات على الإعلانات. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار "خدمات Google Play".
15.0.0	‫12‏/04‏/2018	الإصدار التجريبي 3 من MRAID الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة برمجة التطبيقات Unified Native Ad API. يؤدي ذلك إلى دمج NativeAppInstallAds وNativeContentAds في نوع جديد واحد: UnifiedNativeAd. ملاحظة: عند استخدام "الإعلانات المدمجة مع المحتوى"، يظهر تحذير غير ضار في السجلّات عند النقر على "الإعلان المدمج مع المحتوى": "يجب ألا تكون قيمة UnconfirmedClickListener فارغة أثناء ضبط ClickConfirmingView." يمكن تجاهل هذا التحذير، وستتم إزالته في الإصدار التالي.
12.0.1	‫28‏/03‏/2018	ما مِن تغييرات على الإعلانات. يمكنك الاطّلاع على ملاحظات إصدار "خدمات Google Play" لمزيد من التفاصيل.
12.0.0	‫20/03/2018	إعلانات الفيديو مقابل مكافأة: تمت إضافة طريقة رد الاتصال onRewardedVideoCompleted() إلى RewardedVideoAdListener. لتجنُّب حدوث خطأ في التجميع عند التحديث إلى الإصدار 12.0.0، يجب أن تلغي التطبيقات دالة الاستدعاء هذه في تنفيذ RewardedVideoAdListener. التوسّط المدمج مع المحتوى: تمت إضافة طريقة trackViews() إلى NativeAdMapper، ما يمنح المحوّلات إمكانية الوصول إلى عناصر View المقابلة لمواد عرض الإعلانات المدمجة مع المحتوى الفردية. تم إيقاف trackView() نهائيًا واستخدام trackViews() بدلاً منه.
11.8.0	‫18‏/12‏/2017	تم إصلاح الأخطاء وإجراء تحسينات عامة.
11.6.0	‫07‏/11‏/2017	تمت إضافة الفئة NativeAdViewHolder والطرق ذات الصلة في NativeAppInstallAd وNativeContentAd. تم إيقاف AdLoader.getMediationAdapterClassName نهائيًا (على الناشرين استخدام الطرق التي تحمل الاسم نفسه في NativeAppInstallAd وNativeContentAd بدلاً من ذلك). تعرض الإعلانات الاختبارية الآن تصنيفًا في أعلى الإعلان. يُرجى الاطّلاع على دليل الاختبار لمزيد من التفاصيل.
11.4.0	‫19‏/09‏/2017	تمت إضافة طرق getMediationAdapterClassName() إلى الفئتَين NativeAppInstallAd وNativeContentAd. سيتم إيقاف الطريقة التي تحمل الاسم نفسه في AdLoader نهائيًا. تمت إضافة طريقة onVideoEnd() إلى فئة MediationNativeListener، وطرق hasVideoContent() وsetHasVideoContent() وsetMediaView() إلى فئة NativeAdMapper، وطريقتَي getAdVolume() وisAdMuted() إلى فئة NativeMediationAdRequest لإتاحة التوسّط في عرض إعلانات الفيديو المدمجة مع المحتوى. تمت إزالة الصف "SearchAdRequest".
11.2.2	‫05‏/09‏/2017	تمت إضافة طريقة loadAd() جديدة تستخدم عنصر PublisherAdRequest إلى الفئة RewardedVideoAd.
11.2.0	‫14‏/08‏/2017	تمت إضافة طريقة loadAds() إلى فئة AdLoader، ما يسمح للتطبيقات بتحميل إعلانات فريدة متعددة في طلب واحد. عند ترقية تطبيقك إلى الإصدار 11.2.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، يجب أيضًا تعديل build.gradle في تطبيقك لتحديد compileSdkVersion من الإصدار 26 (Android O) على الأقل. ولا يؤدي ذلك إلى تغيير طريقة تشغيل تطبيقك. لن يُطلب منك تعديل targetSdkVersion. بدءًا من الإصدار 11.2.0، يتوفّر Google Mobile Ads SDK (Legacy) من خلال مستودع Maven من Google. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار "خدمات Google Play".
11.0.0	‫07‏/06‏/2017	تمت إضافة الطريقتَين onAdClicked() وonAdImpression() إلى الفئة AdListener. لا يتم استدعاء هذه الطرق إلا لإعلانات تثبيت التطبيقات المدمجة مع المحتوى وإعلانات المحتوى المدمجة مع المحتوى. تمّت إزالة الدالتين getInAppPurchaseListener() وsetInAppPurchaseListener() من الفئات AdView وInterstitialAd وNativeExpressAdView. تمّت أيضًا إزالة فئات الشراء داخل التطبيق ذات الصلة. تمت إضافة الطرق OnVideoMute() وOnVideoPause() وOnVideoPlay() وOnVideoStart() إلى الفئة VideoController.VideoLifecycleCallbacks. تمت إضافة إمكانية تفعيل "الوضع المجسم" في الإعلانات بملء الشاشة من خلال إضافة الطريقة setImmersiveMode() إلى الفئتَين PublisherInterstitialAd وRewardedVideoAd. تمت إضافة واجهة OnPublisherAdViewLoadedListener وفئة PublisherAdViewOptions وفئة PublisherAdViewOptions.Builder للاستخدام مع AdLoader لطلبات الإعلانات المدمجة مع المحتوى بالإضافة إلى إعلانات البانر. تمت إضافة واجهة OnImmersiveModeUpdatedListener الاختيارية التي يمكن لمحوّلات التوسّط تنفيذها لتلقّي إشعارات بشأن تعديلات الوضع المجسم. تمت إضافة الطريقة getMediationAdapterClassName() إلى الفئة RewardedVideoAd. تمت إضافة قواعد keep للحفاظ تلقائيًا على أسماء فئات محوّلات التوسّط عند استخدام ProGuard.
10.2.0	‫15‏/2‏/2017	الإصدار 10.2.x من "خدمات Google Play" هو أول إصدار لا يتضمّن الدعم الكامل للإصدار 2.3.x من Android (Gingerbread). تتطلّب التطبيقات التي تم تطويرها باستخدام الإصدار 10.2.x من حزمة تطوير البرامج (SDK) والإصدارات الأحدث حدًا أدنى لمستوى واجهة برمجة تطبيقات Android يبلغ 14، ولا يمكن تثبيتها على الأجهزة التي تعمل بمستوى واجهة برمجة تطبيقات أقل من 14. لمزيد من المعلومات حول الخيارات المتاحة لك، بما في ذلك إنشاء حِزم APK متعددة لتوسيع نطاق توافق تطبيقك مع Android Gingerbread، يُرجى الاطّلاع على مدوّنة مطوّري تطبيقات Android. تمت إضافة إمكانية استخدام مواد عرض الفيديو لمحتوى "الإعلانات المدمجة مع المحتوى المتقدّمة" و"إعلانات النماذج المخصّصة". تمت إضافة الطرق getVideoController() وsetVideoOptions() وgetVideoOptions() إلى الفئة PublisherAdView. تمت إضافة فئة AdChoicesView. تمت إضافة الطريقتَين getAdChoicesContent() وsetAdChoicesContent() إلى الفئة NativeAdMapper. تمت إضافة واجهة InitializableMediationRewardedVideoAdAdapter لمحوّلات التوسّط في "إعلانات الفيديو مقابل مكافأة" التي تريد الموافقة على الإعداد المبكر قبل تقديم طلب عرض الإعلان. تمت إضافة إمكانية المعاينة داخل التطبيق وتحديد المشاكل وحلّها في "إدارة إعلانات Google".
10.0.1	‫21‏/11‏/2016	تم إصلاح الأخطاء وإجراء تحسينات عامة.
9.8.0	‫24‏/10‏/2016	تمت إعادة تفعيل MobileAds.Initialize(Context). على الناشرين في "مدير إعلانات Google" استدعاء هذه الطريقة عند إعداد تطبيقاتهم. على الناشرين في AdMob مواصلة استخدام MobileAds.Initialize(Context, String) وإرسال الرمز البرمجي للتطبيق.
9.6.0	‫22-09-2016	تمت إضافة الفئة MediaView لإعلانات الفيديو المدمجة مع المحتوى (متقدّمة). تمت إضافة طريقة openDebugMenu() إلى فئة MobileAds لمعاينة Creative Preview وتحديد المشاكل وحلّها في الوحدات الإعلانية في "مدير إعلانات Google". تمت إضافة إمكانية استخدام الأحداث المخصّصة لإعلانات الفيديو التي تضم مكافأة.
9.4.0	‫1/8/2016	تم إصلاح الأخطاء وإجراء تحسينات عامة.
9.2.0	‫27‏/06‏/2016	تمت إضافة طريقة setAdChoicesPlacement() إلى فئة NativeAdOptions.Builder، والتي يمكن لناشري التطبيقات استخدامها الآن لتحديد موقع AdChoices في "الإعلانات المدمجة مع المحتوى". تم تحسين تشغيل إعلانات الفيديو من خلال إصلاح العديد من الأخطاء.
9.0.1	‫26‏/05‏/2016	يحلّ هذا الإصدار مشكلة في ProGuard ظهرت في الإصدار 9.0.0. لم يعُد الناشرون بحاجة إلى خيار keep لـ com.google.android.gms.common.util.DynamiteApi.
9.0.0	‫18‏/05‏/2016	تمت إضافة ميزة التعبئة التلقائية لمعلومات عن الموقع الجغرافي للجهاز للتطبيقات التي تمنح إذن تحديد الموقع الجغرافي صراحةً. تمت إضافة إمكانية استخدام الأحداث المخصّصة لتوسّط "إعلانات الفيديو مقابل مكافأة". تمت إضافة خيارات الفيديو لإعلانات Native Express. تم تعديل Custom Search Ads API. تمت إضافة طريقة setAppMuted(). لم يعُد الإجراء MobileAds.initialize(android.content.Context, java.lang.String) متوقفًا نهائيًا. تم إيقاف طريقة MobileAds.initialize(android.content.Context) نهائيًا. تمت إضافة طريقة MediationNativeListener.onAdImpression() لإعداد تقارير عن مرّات الظهور في محوّلات التوسّط. بالنسبة إلى هذا الإصدار فقط، على التطبيقات التي تستخدم ProGuard للمعالجة اللاحقة إضافة الخيار keep التالي إلى ملف إعداد ProGuard: -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0	‫18/12/2015	تمت إضافة طريقة عامة، MobileAds.setAppVolume()، لإعلام Google Mobile Ads SDK (Legacy) بمستوى الصوت الحالي للتطبيق. تم إصلاح الأخطاء وإجراء تحسينات.
8.3.0	‫6/11/2015	تمت إضافة إمكانية عرض "إعلانات الفيديو مقابل مكافأة". تمت إضافة طريقة isLoading() إلى PublisherAdView وPublisherInterstitialAd للتحقّق مما إذا كان طلب عرض الإعلان قيد التقدّم. تمت إضافة الطريقة setIsDesignedForFamilies() إلى AdRequest.Builder وPublisherAdRequest.Builder. تمت إضافة طريقة destroy() إلى NativeAdView.
8.1.0	‫24-09-2015	إصلاحات أخطاء متنوّعة.
7.8.0	‫13-08-2015	الإصدار الرسمي من MRAID v2 تمت إضافة طريقة isLoading() إلى AdLoader وAdView وInterstitialAd للتحقّق مما إذا كان طلب عرض الإعلان قيد التنفيذ. تم إيقاف PublisherAdRequest.Builder#setManualImpressionsEnabled() نهائيًا. يمكنك استخدام PublisherAdView#setManualImpressionsEnabled() كبديل.
7.5.0	‫28‏/05‏/2015	تمت إضافة إمكانية استخدام أشكال الإعلانات المدمجة مع المحتوى لتثبيت التطبيقات والمحتوى على AdMob و"مدير إعلانات Google". تمت إضافة إمكانية استخدام أشكال "الإعلانات المدمجة مع المحتوى" المخصّصة، وهي متاحة للحجوزات في "إدارة إعلانات Google".
7.3.0	‫28-04-2015	إصلاحات أخطاء متنوّعة.
7.0.0	‫19‏/03‏/2015	تمت إضافة الطريقتَين addCustomTargeting() وaddCategoryExclusion() إلى PublisherAdRequest.Builder. تم إصلاح مشكلة كانت تؤدي إلى تسجيل PublisherAdView.recordManualImpression() مرات ظهور متعددة في "إدارة إعلانات Google" عند استخدام ميزة احتساب مرات الظهور يدويًا. تم إصلاح مشكلة كانت تؤدي إلى عرض الإعلانات بشكل غير صحيح عند استخدام السمة android:largestWidthLimitDp في علامة <supports-screens>. تمت إضافة الطريقة setRequestAgent() إلى AdRequest.Builder وPublisherAdRequest.Builder. يجب استخدام هذه الطريقة للإشارة إلى مصادر طلبات عرض الإعلانات من قِبل الجهات الخارجية التي تتوسّط إلى Google Mobile Ads SDK (Legacy).
6.5.87	‫08‏/12‏/2014	تم تقديم بنية JAR المقسّمة، ويمكن الآن لمطوّري Android Studio تضمين جزء الإعلانات فقط من "خدمات Google Play" بالاعتماد على com.google.android.gms:play‑services‑ads:6.+. ملاحظة: يجب أن تشير التطبيقات التي تنشئ "إعلانات البانر" بتنسيق XML إلى المكتبة com.google.android.gms:play‑services:6.+ بأكملها. إصلاحات أخطاء متنوّعة.
6.1	‫08‏/10‏/2014	تمت إضافة طريقة getLocation() إلى com.google.android.gms.ads.MediationAdRequest. تمت إضافة وصف محتوى إلى زر إغلاق الإعلان البيني لتسهيل الاستخدام. تمت إزالة تسجيل "لم يتم العثور على موارد Google Play" عندما يكون مشروع المكتبة مرتبطًا بشكل صحيح. تمت إضافة getMediationAdapterClassName() إلى AdView للحصول على اسم فئة محوّل التوسّط لشبكة المواقع الإعلانية الذي يعرض إعلانًا.
17.0.0	‫05‏/10‏/2018	تمت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ الأحداث المخصّصة. تمت إضافة مسار الشراء التلقائي لعمليات الشراء داخل التطبيق باستخدام واجهة Google Play Billing API.
4.4	‫07-05-2014	تمت إضافة واجهات برمجة تطبيقات جديدة لمحوّلات التوسّط. تمت إضافة شكل إعلان جديد بحجم 320×100 LARGE_BANNER لكل من الهواتف والأجهزة اللوحية. تمت إضافة شكل جديد للإعلانات البينية لعمليات الشراء داخل التطبيق. يمكنك ضبط InAppPurchaseListener على InterstitialAd للاستماع إلى أحداث عملية الشراء داخل التطبيق. تم إصلاح الخطأ الذي يؤدي إلى تعطُّل "SecurityException" بسبب قراءة gservices بدون إذن.
4.3	‫17‏/03‏/2014	تعمل دالة InterstitialAd الآن إذا تم تمرير سياق التطبيق. تمت إضافة طريقة setContentUrl() إلى PublisherAdRequest.Builder. تم إصلاح الاستثناء عند ظهور رسالة الخدمة غير مسجَّلة.
‫4.2	‫03-02-2014	إصلاحات أخطاء متنوّعة.
4.1	‫16‏/01‏/2014	تمت إضافة ميزة التوافق مع "مدير إعلانات Google" و"إعلانات شبكة البحث للتطبيقات المتوافقة مع الأجهزة الجوّالة". تتضمّن السمة AdRequest.Builder الآن طريقة setLocation(). تم إصلاح عطل حدث عند طلب إعلان بيني بدون تحديد AdActivity في البيان.
4.0	‫31-10-2013	أصبحت واجهات برمجة تطبيقات "إعلانات Google على الأجهزة الجوّالة" الآن جزءًا من خدمات Google Play. يتم تلقائيًا إرسال التحديثات المستقبلية لواجهات Google Mobile Ads API إلى الأجهزة من خلال "خدمات Google Play". لا تتوفّر بعد "إعلانات Google" و"إعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة.