نقل إصدارات حزمة SDK

اختيار النظام الأساسي: iOS Unity Android (القديم)

تاريخ آخر تعديل: 17 سبتمبر 2026

تتناول هذه الصفحة عمليات نقل البيانات للإصدارات الحالية والسابقة.

نقل البيانات من الإصدار 24 إلى الإصدار 25

توضّح الفقرات الفرعية التالية التغييرات التي قد تؤدي إلى عطل والاختلافات في السلوك بين رقمَي الإصدار الرئيسي 24 و25 من Google Mobile Ads SDK (Legacy).

الحد الأدنى لمستوى واجهة برمجة تطبيقات Android هو 24

بدءًا من الإصدار 25.5.0، تتطلّب حزمة Google Mobile Ads SDK (Legacy) تشغيل جميع التطبيقات على المستوى 24 من واجهة برمجة التطبيقات لنظام التشغيل Android كحدّ أدنى. لضبط مستوى واجهة برمجة التطبيقات، غيِّر قيمة minSdk في ملف build.gradle على مستوى التطبيق إلى 24 أو أعلى.

تمت إزالة عمليات الاستدعاء المتوقفة نهائيًا للإعلانات

تمت إزالة عمليات الاستدعاء المتوقفة نهائيًا التالية للإعلانات من الفئات التالية:

الفئة	تمت إزالة عمليات إعادة الاتصال	البديل
SignalCallbacks	onFailure(String) onAdFailedToShow(String)	onFailure(AdError) onAdFailedToShow(AdError)
MediationAdLoadCallback
MediationInterstitialAdCallback
MediationRewardedAdCallback

تغييرات على واجهات برمجة التطبيقات الخاصة بحجم "إعلانات البانر التكيُّفية الثابتة"

في الإصدار 25.0.0، تم إيقاف واجهات برمجة التطبيقات الحالية الخاصة بحجم "إعلانات البانر التكيُّفية الثابتة"، وتم تقديم واجهات برمجة تطبيقات جديدة خاصة بحجم "إعلانات البانر التكيُّفية الثابتة الكبيرة". يمكن لـ "Google Mobile Ads SDK (Legacy)" عرض إعلانات الفيديو على "إعلانات البانر" باستخدام واجهات برمجة التطبيقات الجديدة الخاصة بحجم "إعلانات البانر التكيُّفية الثابتة الكبيرة".

يوضّح الجدول التالي واجهات برمجة التطبيقات المتوقّفة نهائيًا لتحديد الحجم وبدائلها:

الإصدار 24 (متوقّف نهائيًا)	v25 (بديل)
getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int)	getLargeAnchoredAdaptiveBannerAdSize(Context, int)
getLandscapeAnchoredAdaptiveBannerAdSize(Context, int)	getLargeLandscapeAnchoredAdaptiveBannerAdSize(Context, int)
getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)	getLargePortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

إزالة صف mediation.VersionInfo

تمت إزالة فئة VersionInfo في حزمة com.google.android.gms.ads.mediation. استخدِم حزمة com.google.android.gms.ads.VersionInfo بدلاً من ذلك.

إزالة طريقة getConfiguration() في فئة RtbSignalData

تمت إزالة الطريقة المتوقّفة نهائيًا getConfiguration() API في RtbSignalData. بدلاً من ذلك، استخدِم الطريقة getConfigurations() التي تعرض قائمة List<MediationConfiguration>.

نقل البيانات من الإصدار 23 إلى الإصدار 24

توضّح الفقرات الفرعية التالية التغييرات التي قد تؤدي إلى عطل والاختلافات في السلوك بين رقمَي الإصدار الرئيسي 23 و24 من Google Mobile Ads SDK (Legacy).

الحدّ الأدنى لمستوى واجهة برمجة تطبيقات Android هو 23

اعتبارًا من الإصدار 24.0.0، يتطلّب "Google Mobile Ads SDK (Legacy)" تشغيل جميع التطبيقات على المستوى 23 من واجهة برمجة التطبيقات لنظام التشغيل Android كحدّ أدنى. لضبط مستوى واجهة برمجة التطبيقات، غيِّر قيمة minSdk في ملف build.gradle على مستوى التطبيق إلى 23 أو أعلى.

التغييرات في الإعداد والتحميل المحسّنَين

يتم ضبط علامتَي OPTIMIZE_INITIALIZATION وOPTIMIZE_AD_LOADING تلقائيًا على true. لمزيد من المعلومات حول هذه العلامات، يُرجى الاطّلاع على مقالة تحسين عملية الإعداد والتحميل.

تمت إزالة تبعيات firebase-ads وfirebase-ads-lite

بدءًا من الإصدار 24.0.0، لن توزّع إصدارات حزمة تطوير البرامج (SDK) التبعيات firebase-ads وfirebase-ads-lite. استخدِم التبعية play-services-ads بدلاً من ذلك.

ضبط مَعلمات الاستهداف المخصّصة

لضبط استهداف مخصّص في طلب عرض الإعلان، استخدِم addCustomTargeting().

تمت إزالة واجهات برمجة التطبيقات المتوقّفة نهائيًا الخاصة باتجاه "الإعلانات على شاشة فتح التطبيق"

• تمت إزالة طرق AppOpenAd.load() التي تقبل مَعلمة إدخال الاتجاه. استخدِم بدلاً من ذلك طرق AppOpenAd.load() التي لا تتطلّب تحديد الاتجاه.
• تمت إزالة التعداد AppOpenAdOrientation.

عملية مبسّطة لطلب معاودة الاتصال للحصول على مكافأة في محوّلات التوسّط

يضيف الإصدار 24.0.0 دالة الاستدعاء onUserEarnedReward() في MediationRewardedAdCallback ويوقف نهائيًا onUserEarnedReward(RewardItem). يجب أن تبدأ محوّلات التوسّط في استدعاء onUserEarnedReward() عندما يحصل المستخدم على مكافأة.

عند إعادة توجيه عمليات معاودة الاتصال من محوّلات التوسّط، تعرض جميع إصدارات Google Mobile Ads SDK (Legacy) المكافأة المحدّدة في واجهة مستخدم "مدير الإعلانات" في OnUserEarnedRewardListener.

الصفوف التي تمت إزالتها

تمت إزالة الفئات التالية بدون استبدالها:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

تمت إزالة الطرق

تمت إزالة الطرق التالية بدون بديل:

الفئة	الطريقة
RewardedInterstitialAdLoadCallback	onRewardedInterstitialAdLoaded()
	onRewardedInterstitialAdFailedToLoad(int)
	onRewardedInterstitialAdFailedToLoad(LoadAdError)

الطرق التي تم إيقافها نهائيًا

تم إيقاف الطرق التالية نهائيًا بدون بديل:

الفئة	الطريقة
مُنسّق	loadInterscrollerAd()
RtbAdapter	loadRtbInterscrollerAd()

نقل البيانات من الإصدار 22 إلى الإصدار 23

توضّح الفقرات الفرعية التالية التغييرات التي قد تؤدي إلى عطل والاختلافات في السلوك بين رقمَي الإصدار الرئيسي 22 و23 من "Google Mobile Ads SDK (Legacy)".

الحد الأدنى لمستوى واجهة برمجة تطبيقات Android هو 21

اعتبارًا من الإصدار 23.0.0، تتطلّب حزمة "Google Mobile Ads SDK (Legacy)" أن تكون جميع التطبيقات على المستوى 21 من واجهة برمجة التطبيقات لنظام التشغيل Android كحدّ أدنى لكي تعمل. لضبط مستوى واجهة برمجة التطبيقات، غيِّر قيمة minSdkVersion في ملف build.gradle على مستوى التطبيق إلى 21 أو أعلى.

يمكن ربط طريقتَين (AdManagerAdRequest.Builder) موروثتَين من الفئة الفائقة

في الإصدار 23.0.0، يمكن ربط طرق AdManagerAdRequest.Builder الموروثة من فئتها الرئيسية معًا لإنشاء AdManagerAdRequest باستخدام طلب واحد:

جافا

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

Kotlin

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

ملاحظة: من الآثار الجانبية لهذا التغيير أنّ AdManagerAdRequest.Builder لم يعُد يكتسب سمات من AdRequest.Builder.

إزالة/استبدال الطرق المتوقفة نهائيًا

الإصدار 22.0.0 من واجهة برمجة التطبيقات	الإصدار 23.0.0 من واجهة برمجة التطبيقات
AdRequest.Builder.addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()
AdRequest.Builder.tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()
AdRequest.Builder.setIsDesignedForFamilies()	RequestConfiguration.Builder.setMaxAdContentRating()
AdFormat.UNKNOWN	ما مِن بديل
AdLoader.Builder.forUnifiedNativeAd()	AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd()	AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.formats.NativeAdOptions)	AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.nativead.NativeAdOptions)
void MobileAds.setSameAppKeyEnabled()	boolean MobileAds.putPublisherFirstPartyIdEnabled()

نقل البيانات من الإصدار 21 إلى الإصدار 22

توضّح الفقرات الفرعية التالية التغييرات التي قد تؤدي إلى عطل والاختلافات في السلوك بين رقمَي الإصدار الرئيسي 21 و22 من Google Mobile Ads SDK (Legacy).

استخدِم MobileAds.getVersion()‎ للحصول على إصدار Google Mobile Ads SDK (Legacy)

تمت إزالة طريقة MobileAds.getVersionString() في الإصدار 22.0.0 واستبدالها بـ MobileAds.getVersion().

تُنتج الطريقة الجديدة رقم الإصدار الخارجي المتوقّع، على سبيل المثال، 22.0.0. لمزيد من المعلومات حول هذا التغيير، يُرجى الاطّلاع على استخدام طريقة حزمة SDK الجديدة لإعلانات Google على الأجهزة الجوّالة getVersion().

إزالة NativeCustomFormatAd.getVideoMediaView() الذي تم إيقافه نهائيًا

في الإصدار 21، وفّر لك Google Mobile Ads SDK (Legacy) طريقة NativeCustomFormatAd.getVideoMediaView() للحصول على ملف وسائط لشكل إعلان مخصّص مدمج مع المحتوى.

بدءًا من الإصدار 22، يمكنك إنشاء MediaView وضبط محتوى الوسائط الخاص به، واستخدام MediaContent.getVideoController() للحصول على عناصر التحكّم في الفيديو.

v22

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

v21

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

يمكنك الاطّلاع على دليل الإعلانات المدمجة مع المحتوى المخصّصة لمزيد من المعلومات.

الطرق التي تمت إزالتها أو استبدالها

يسرد الجدول التالي التغييرات المحدّدة في الإصدار 22.0.0:

v21.0.0	v22.0.0
MobileAds.getVersionString()	MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView()	NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController()	NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo()	AdRequest.Builder.setAdString()
MediationRewardedVideoAdAdapter	المحوِّل
MediationRewardedVideoAdListener
com.google.android.gms.ads.mediation.VersionInfo	com.google.android.gms.ads.VersionInfo
com.google.android.gms.ads.doubleclick.AppEventListener	com.google.android.gms.ads.admanager.AppEventListener

نقل البيانات من الإصدار 20 إلى الإصدار 21

توضّح الفقرات الفرعية التالية التغييرات التي قد تؤدي إلى عطل والاختلافات في السلوك بين رقمَي الإصدار الرئيسي 20 و21 من Google Mobile Ads SDK (Legacy):

تحديث minSdkVersion إلى الإصدار 19 أو إصدار أحدث

اعتبارًا من الإصدار 21.0.0، تتطلّب حزمة "Google Mobile Ads SDK (Legacy)" أن تكون جميع التطبيقات على المستوى 19 من واجهة برمجة التطبيقات لنظام التشغيل Android كحدّ أدنى لكي تعمل. لضبط مستوى واجهة برمجة التطبيقات، غيِّر قيمة minSdkVersion في ملف إصدار تطبيقك إلى 19 أو أعلى.

فرض إمكانية قبول القيم الفارغة بشكل صارم

استعدادًا لفرض سياسة صارمة بشأن إمكانية قبول القيم الفارغة، تتم إضافة تعليقات توضيحية @NonNull في جميع واجهات برمجة التطبيقات التي لم تحدّد سابقًا إمكانية قبول القيم الفارغة بشكل صريح.

قد يؤدي هذا التغيير إلى تعطُّل تطبيقات Kotlin والتطبيقات التي تستخدم أُطر عمل التحقّق من القيم الفارغة في Java إذا كانت هناك انتهاكات لسلامة القيم الفارغة ولم يتم التعامل مع قيم null بطريقة آمنة في السابق (يُرجى الاطّلاع على مستندات Kotlin حول سلامة القيم الفارغة).

إزالة طريقة addNetworkExtras()‎

تم إيقاف طريقة addNetworkExtras() التي تمرّر مَعلمات إضافية كنسخة NetworkExtras إلى محوّل شبكة إعلانات معيّن نهائيًا في الإصدار 20.3.0 من حزمة تطوير البرامج (SDK)، وستتم إزالتها في الإصدار 21.0.0. استخدِم طريقة addNetworkExtrasBundle() من فئة AdRequest.Builder نفسها بدلاً من ذلك.

إزالة طرق تحديد الموقع الجغرافي

ستتم إزالة طرق تحديد الموقع الجغرافي التالية في الإصدار 21.0.0:

• الطريقة setLocation(Location location) في الفئة AdRequest.Builder التي تضبط الموقع الجغرافي للمستخدم لأغراض استهداف التوسّط.
• الطريقة getLocation() في الفئة AdRequest التي تعرض معلومات الاستهداف حسب الموقع الجغرافي للمستخدم والتي تم تمريرها سابقًا إلى الطريقة setLocation(Location location)
• الطريقة getLocation() في الفئة MediationAdConfiguration التي تعرض الموقع الجغرافي للمستخدم، إذا تم تحديده من خلال AdRequest.

ولا تستخدم Google بيانات الموقع الجغرافي لاستهداف الإعلانات. وعليك استخدام واجهات برمجة التطبيقات التابعة لجهات خارجية لتقديم المعلومات إلى شبكات الإعلانات التابعة لجهات خارجية إذا لزم الأمر.

إيقاف واجهات الأحداث المخصّصة نهائيًا

تتيح الأحداث المخصّصة للناشرين الذين يستخدمون ميزة التوسّط إعداد مصدر إعلانات للعرض بدون انقطاع ليس من مصادر الإعلانات المتوافقة مع "إدارة إعلانات Google".

تم إيقاف جميع واجهات الأحداث المخصّصة نهائيًا لصالح فئة Adapter وواجهة MediationAdLoadCallback.

يسرد الجدول التالي الفئة أو الواجهة المقابلة التي يجب استخدامها لكل واجهة حدث مخصّص بدءًا من الإصدار 21.0.0:

واجهات الإصدار 20.0.0	فئة/واجهة الإصدار 21.0.0
CustomEvent	المحوِّل
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	Adapter, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

نقل البيانات من الإصدار 19 إلى الإصدار 20

هناك العديد من التغييرات التي قد تؤدي إلى عطل في الإصدار 20.0.0. يقدّم الإصدار 19.7.0 العديد من واجهات برمجة التطبيقات الجديدة، كما تم إيقاف العديد من الفئات نهائيًا أو إعادة تسميتها استعدادًا للإصدار 20.0.0. يُبرز هذا الدليل التغييرات الرئيسية في الإصدار 20.0.0.

تعديلات على واجهة برمجة التطبيقات الخاصة بتنسيق ملء الشاشة

بدءًا من الإصدار 20.0.0، تم توحيد أشكال "الإعلانات البينية" و"الإعلانات مقابل مكافأة" و"الإعلانات البينية مقابل مكافأة" و"الإعلانات على شاشة فتح التطبيق" لتتّبع تصميمًا متسقًا لواجهة برمجة التطبيقات.

تستخدم جميع واجهات برمجة التطبيقات الخاصة بأشكال الإعلانات بملء الشاشة المبادئ التالية:

• طريقة تحميل ثابتة
• آلية مشابهة لمعالجة طلبات معاودة الاتصال أو معالجة التحميل
• الاعتماد على فئة FullScreenContentCallback لعمليات معاودة الاتصال الخاصة بالعرض

إزالة واجهة برمجة التطبيقات RewardedVideoAd القديمة

تم طرح واجهة برمجة التطبيقات الأحدث RewardedAd لأول مرة في مارس 2019، وكانت واجهة برمجة التطبيقات المفضّلة للإعلانات التي تضم مكافآت لأكثر من 18 شهرًا. وقد تم إجراء المزيد من التحسينات مقارنةً بواجهة برمجة التطبيقات القديمة RewardedVideoAd، بما في ذلك إمكانية تحميل أكثر من إعلان واحد مقابل مكافأة في كل مرة.

تمت إزالة واجهة برمجة التطبيقات القديمة RewardedVideoAd في الإصدار 20.0.0 من حزمة تطوير البرامج (SDK).

إيقاف إعلانات البانر الذكية نهائيًا واستبدالها بإعلانات البانر التكيُّفية

تم إيقاف إعلانات البانر الذكية نهائيًا واستبدالها بإعلانات البانر التكيُّفية. توفّر "إعلانات البانر التكيُّفية" أداءً فائقًا ومرونة أكبر في تحديد عرض الإعلان. إذا كنت تفضّل مواصلة استخدام إعلانات البانر التي تشغل العرض الكامل، يمكنك إجراء ذلك باستخدام إعلان بانر تكيُّفي، كما هو موضّح في مقتطف الرمز التالي:

جافا

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

Kotlin

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

إزالة استدعاء الوظيفة عند مغادرة التطبيق

تمت إزالة دالة الاستدعاء onAdLeftApplication لجميع أشكال الإعلانات لصالح ProcessLifecycleOwner. يؤدي استخدام واجهة برمجة تطبيقات على مستوى نظام التشغيل إلى إعلامك عندما يغادر المستخدمون تطبيقك، بغض النظر عمّا إذا كان ذلك بسبب تفاعل مع الإعلان أم لا.

يُرجى العِلم أنّ دالة الاستدعاء onAdLeftApplication لم تكن مخصّصة مطلقًا لمعالجة النقرات على الإعلانات، ولم يؤدِّ الاعتماد على دالة الاستدعاء هذه للإبلاغ عن النقرات إلى الحصول على مقياس دقيق. على سبيل المثال، أدّت النقرة على رمز "خيارات الإعلان" الذي شغّل متصفّحًا خارجيًا إلى استدعاء دالة ردّ الاتصال، ولكن لم يتم احتسابها كنقرة.

إعادة تسمية الصفوف

يسرد الجدول التالي أسماء فئات معيّنة تم تغييرها أو إزالتها:

• تمت إعادة تسمية معظم الفئات ذات الصلة بـ UnifiedNativeAd إلى NativeAd.
• تمت إزالة الفئات والعروض MobileAds.Settings وNativeExpressAdView وNativeAppInstallAd وNativeContentAd وInstreamAd.
• تم استبدال جميع الفئات التي تبدأ بالبادئة Publisher ببادئة AdManager.
• تم تغيير اسم حزمة InterstitialAd.

الصف 19.5.0	الإصدار 20.0.0 من Class
com.google.android.gms.ads.	com.google.android.gms.ads.
reward.RewardedVideoAd	rewarded.RewardedAd
reward.RewardedVideoAdListener	‫rewarded.RewardedAdLoadCallback وFullScreenContentCallback
reward.RewardItem	rewarded.RewardItem
rewarded.RewardedAdCallback	OnUserEarnedRewardListener
formats.UnifiedNativeAdView	nativead.NativeAdView
formats.UnifiedNativeAd	nativead.NativeAd
formats.UnifiedNativeAdAssetNames	nativead.NativeAdAssetNames
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener	nativead.NativeAd.OnNativeAdLoadedListener
formats.AdChoicesView	nativead.AdChoicesView
formats.NativeAd.AdChoicesInfo	nativead.NativeAd.AdChoicesInfo
formats.MediaView	nativead.MediaView
formats.NativeAdViewHolder	nativead.NativeAdViewHolder
formats.NativeAdOptions	nativead.NativeAdOptions
formats.NativeCustomTemplateAd	nativead.NativeCustomFormatAd
formats.NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener	nativead.NativeCustomFormatAd.OnCustomFormatAdLoadedListener
MobileAds.Settings	تمّت إزالته
doubleclick.PublisherAdRequest	admanager.AdManagerAdRequest
doubleclick.PublisherAdView	admanager.AdManagerAdView
formats.PublisherAdViewOptions	formats.AdManagerAdViewOptions
doubleclick.PublisherInterstitialAd	admanager.AdManagerInterstitialAd
InterstitialAd	interstitial.InterstitialAd
NativeExpressAdView	تمّت إزالته
instream.InstreamAd	تمّت إزالته
mediation.admob.AdMobExtras	تمّت إزالته
Correlator	تمّت إزالته
search.SearchAdRequest	تمّت إزالته
الواجهة AdRequest.TagForUnderAgeOfConsent	تمّت إزالته
Interface AdRequest.MaxAdContentRating	تمّت إزالته
formats.NativeAppInstallAd	native.NativeAd
formats.NativeAppInstallAdView	native.NativeAdView
mediation.NativeAppInstallAdMapper	mediation.UnifiedNativeAdMapper
formats.NativeContentAd	native.NativeAd
formats.NativeContentAdView	native.NativeAdView
mediation.NativeContentAdMapper	mediation.UnifiedNativeAdMapper

الطرق التي تمت إزالتها أو استبدالها

يسرد الجدول التالي التغييرات المحدّدة في الإصدار 20.0.0:

• تمت إزالة طرق الإعداد القديمة من فئة MobileAds.
• تمت إزالة بعض الطرق من فئة AdRequest.Builder() أو نقلها إلى فئة RequestConfiguration.
• تم تعديل واجهتَي برمجة التطبيقات RewardedAd وInterstitialAd لتتوافقا مع جميع أشكال الإعلانات بملء الشاشة.
• تمت إزالة ميزات Correlator.

الفئة	الإصدار 19.5.0 من واجهة برمجة التطبيقات	الإصدار 20.0.0 من واجهة برمجة التطبيقات	ملاحظات
AdSize	getPortraitBannerAdSizeWithWidth()	getPortraitAnchoredAdaptiveBannerAdSize()‎
	getLandscapeBannerAdSizeWithWidth()‎	getLandscapeAnchoredAdaptiveBannerAdSize()‎
	getCurrentOrientationBannerAdSizeWithWidth()‎	getCurrentOrientationAnchoredAdaptiveBannerAdSize()‎
MobileAds	initialize(Context, String)	MobileAds.initialize(Context, OnInitializationCompleteListener)	تم الآن ضبط رقم تعريف التطبيق في ملف AndroidManifest.xml.
	initialize(Context, String, MobileAds.Settings)‎	initialize(Context, OnInitializationCompleteListener)	تم إيقاف فئة Settings نهائيًا.
	getRewardedVideoAdInstance()‎	تمّت إزالته	استخدِم RewardedAd API بدلاً من ذلك.
AdListener	onAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onAdLeftApplication()	تمّت إزالته	تستخدم أشكال الإعلانات بملء الشاشة FullscreenContentCallback بدلاً من AdListener، ولا توجد طريقة مكافئة في FullscreenContentCallback. تمت إزالة الطريقة من AdListener.
VideoController	getAspectRatio()	MediaContent.getAspectRatio()
PublisherAdRequest	getGender()	تمّت إزالته
	getBirthday()	تمّت إزالته
	getNetworkExtras()	تمّت إزالته
	setManualImpressionsEnabled()	تمّت إزالته
	updateCorrelator()	تمّت إزالته	يُرجى الاطّلاع على فلترة محتوى الإعلانات.
PublisherAdRequest.Builder	setBirthday()	تمّت إزالته
	setGender()	تمّت إزالته
	setIsDesignedForFamilies()	تمّت إزالته	يُرجى الاطّلاع على الدليل.
	addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()	اطّلِع على تفعيل الإعلانات الاختبارية.
	tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()	يُرجى الاطّلاع على فلترة محتوى الإعلانات.
	setTagForUnderAgeOfConsent()‎	RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
	setMaxAdContentRating()	RequestConfiguration.Builder.setMaxAdContentRating()
AdView	getMediationAdapterClassName()‎	ResponseInfo.getMediationAdapterClassName()	يتوفّر عنصر ResponseInfo باستخدام الإجراء AdView، getResponseInfo().
NativeAdOptions	setImageOrientation()	setMediaAspectRatio()
	getImageOrientation	getMediaAspectRatio()
RewardedAd	loadAd(AdRequest, RewardedAdLoadCallback)	RewardedAd.load(Context, String, AdRequest, RewardedAdLoadCallback)	يستخدم RewardedAd الآن أسلوب التحميل الثابت نفسه الذي تستخدمه أشكال الإعلانات الأخرى التي تظهر بملء الشاشة.
	loadAd(PublisherAdRequest, RewardedAdLoadCallback)	RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback)
	isLoaded()	تمّت إزالته	توفّر دالة الاستدعاء من طريقة التحميل الثابتة إعلانًا تم تحميله مسبقًا.
	show(Activity, RewardedAdCallback)	show(Activity, OnUserEarnedRewardListener)	تلتزم طريقة العرض هذه بنهج شكل ملء الشاشة الأوسع نطاقًا.
RewardedAdLoadCallback	onRewardedAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedAdLoaded()	onAdLoaded(RewardedAd)
AppOpenAdLoadCallback	onAppOpenAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdLoaded(AppOpenAd)	onAdLoaded(AppOpenAd)
RewardedInterstitialAdLoadCallback	onRewardedInterstitialAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdLoaded(RewardedInterstitialAd)	onAdLoaded(RewardedInterstitialAd)
PublisherInterstitialAd	new PublisherInterstitialAd()‎	InterstitialAd.load(Context, String, AdRequest, InterstitialAdLoadCallback)	يستخدم InterstitialAd الآن أسلوب التحميل الثابت نفسه الذي تستخدمه أشكال الإعلانات الأخرى بملء الشاشة.
	setAdListener()
DynamicHeightSearchAdRequest	getNetworkExtras()	تمّت إزالته	تم إيقاف فئة NetworkExtras نهائيًا.
AdLoader	forContentAd()	تمّت إزالته
	forAppInstallAd()‎	تمّت إزالته
	withCorrelator()	تمّت إزالته
	getMediationAdapterClassName()‎	تمّت إزالته