Add unit tests for AppOpenAdPreloader.PeekAdResponseInfo.

PiperOrigin-RevId: 952974572

Author: Mobile Ads Developer Relations

source/plugin/Assets/GoogleMobileAds/Api/AppOpenAdPreloader.cs

@@ -127,7 +127,7 @@ public static Dictionary<string, PreloadConfiguration> GetConfigurations()
         /// Returns a preloaded ad and removes it from the cache.
         /// </summary>
         /// <param name="preloadId">
-        /// The ad's preload ID.
+        /// A string identifier used to preload the ads for that configuration.
         /// </param>
         /// <returns>
         /// The preloaded ad for the given preload ID, or null if no ad is available.
@@ -146,6 +146,26 @@ public static AppOpenAd DequeueAd(string preloadId)
             return new AppOpenAd(client);
         }
 
+        /// <summary>
+        /// Returns the ResponseInfo of a preloaded ad for the given preload ID without
+        /// dequeuing it, or null if no ad is available.
+        /// </summary>
+        /// <param name="preloadId">
+        /// A string identifier used to preload the ads for that configuration.
+        /// </param>
+        /// <returns>
+        /// The ResponseInfo of the preloaded ad for the given preload ID, or null if no ad is available.
+        /// </returns>
+        public static ResponseInfo PeekAdResponseInfo(string preloadId)
+        {
+            var responseInfoClient = _client.PeekAdResponseInfo(preloadId);
+            if (responseInfoClient == null)
+            {
+                return null;
+            }
+            return new ResponseInfo(responseInfoClient);
+        }
+
         /// <summary>
         /// Get the number of ads available for the given preload ID.
         /// </summary>

source/plugin/Assets/GoogleMobileAds/Api/InterstitialAdPreloader.cs

@@ -127,7 +127,7 @@ public static Dictionary<string, PreloadConfiguration> GetConfigurations()
         /// Returns a preloaded ad and removes it from the cache.
         /// </summary>
         /// <param name="preloadId">
-        /// The ad's preload ID.
+        /// A string identifier used to preload the ads for that configuration.
         /// </param>
         /// <returns>
         /// The preloaded ad for the given preload ID, or null if no ad is available.
@@ -146,6 +146,26 @@ public static InterstitialAd DequeueAd(string preloadId)
             return new InterstitialAd(client);
         }
 
+        /// <summary>
+        /// Returns the ResponseInfo of a preloaded ad for the given preload ID without
+        /// dequeuing it, or null if no ad is available.
+        /// </summary>
+        /// <param name="preloadId">
+        /// A string identifier used to preload the ads for that configuration.
+        /// </param>
+        /// <returns>
+        /// The ResponseInfo of the preloaded ad for the given preload ID, or null if no ad is available.
+        /// </returns>
+        public static ResponseInfo PeekAdResponseInfo(string preloadId)
+        {
+            var responseInfoClient = _client.PeekAdResponseInfo(preloadId);
+            if (responseInfoClient == null)
+            {
+                return null;
+            }
+            return new ResponseInfo(responseInfoClient);
+        }
+
         /// <summary>
         /// Get the number of ads available for the given preload ID.
         /// </summary>

source/plugin/Assets/GoogleMobileAds/Api/RewardedAdPreloader.cs

@@ -126,7 +126,7 @@ public static Dictionary<string, PreloadConfiguration> GetConfigurations()
         /// Returns a preloaded ad and removes it from the cache.
         /// </summary>
         /// <param name="preloadId">
-        /// The ad's preload ID.
+        /// A string identifier used to preload the ads for that configuration.
         /// </param>
         /// <returns>
         /// The preloaded ad for the given preload ID, or null if no ad is available.
@@ -145,6 +145,26 @@ public static RewardedAd DequeueAd(string preloadId)
             return new RewardedAd(client);
         }
 
+        /// <summary>
+        /// Returns the ResponseInfo of a preloaded ad for the given preload ID without
+        /// dequeuing it, or null if no ad is available.
+        /// </summary>
+        /// <param name="preloadId">
+        /// A string identifier used to preload the ads for that configuration.
+        /// </param>
+        /// <returns>
+        /// The ResponseInfo of the preloaded ad for the given preload ID, or null if no ad is available.
+        /// </returns>
+        public static ResponseInfo PeekAdResponseInfo(string preloadId)
+        {
+            var responseInfoClient = _client.PeekAdResponseInfo(preloadId);
+            if (responseInfoClient == null)
+            {
+                return null;
+            }
+            return new ResponseInfo(responseInfoClient);
+        }
+
         /// <summary>
         /// Get the number of ads available for the given preload ID.
         /// </summary>

source/plugin/Assets/GoogleMobileAds/Common/IAppOpenAdPreloaderClient.cs

@@ -76,6 +76,18 @@ bool Preload(string preloadId, PreloadConfiguration preloadConfiguration,
         /// </remarks>
         IAppOpenAdClient DequeueAd(string preloadId);
 
+        /// <summary>
+        /// Returns the ResponseInfo of an ad available for the given preload ID without
+        /// dequeuing it, or null if no ad is available.
+        /// </summary>
+        /// <param name="preloadId">
+        /// A string identifier used to preload the ads for that configuration.
+        /// </param>
+        /// <returns>
+        /// The ResponseInfo of the preloaded ad for the given preload ID, or null if no ad is available.
+        /// </returns>
+        IResponseInfoClient PeekAdResponseInfo(string preloadId);
+
         /// <summary>
         /// Get the number of ads available for the given preload ID.
         /// </summary>

source/plugin/Assets/GoogleMobileAds/Common/IInterstitialAdPreloaderClient.cs

@@ -65,7 +65,7 @@ bool Preload(string preloadId, PreloadConfiguration preloadConfiguration,
         /// Returns a preloaded ad and removes it from the cache.
         /// </summary>
         /// <param name="preloadId">
-        /// The ad's preload ID.
+        /// A string identifier used to preload the ads for that configuration.
         /// </param>
         /// <returns>
         /// The preloaded ad for the given preload ID, or null if no ad is available.
@@ -76,6 +76,18 @@ bool Preload(string preloadId, PreloadConfiguration preloadConfiguration,
         /// </remarks>
         IInterstitialClient DequeueAd(string preloadId);
 
+        /// <summary>
+        /// Returns the ResponseInfo of an ad available for the given preload ID without
+        /// dequeuing it, or null if no ad is available.
+        /// </summary>
+        /// <param name="preloadId">
+        /// A string identifier used to preload the ads for that configuration.
+        /// </param>
+        /// <returns>
+        /// The ResponseInfo of the preloaded ad for the given preload ID, or null if no ad is available.
+        /// </returns>
+        IResponseInfoClient PeekAdResponseInfo(string preloadId);
+
         /// <summary>
         /// Get the number of ads available for the given preload ID.
         /// </summary>

source/plugin/Assets/GoogleMobileAds/Common/IRewardedAdPreloaderClient.cs

@@ -65,7 +65,7 @@ bool Preload(string preloadId, PreloadConfiguration preloadConfiguration,
         /// Returns a preloaded ad and removes it from the cache.
         /// </summary>
         /// <param name="preloadId">
-        /// The ad's preload ID.
+        /// A string identifier used to preload the ads for that configuration.
         /// </param>
         /// <returns>
         /// The preloaded ad for the given preload ID, or null if no ad is available.
@@ -76,6 +76,18 @@ bool Preload(string preloadId, PreloadConfiguration preloadConfiguration,
         /// </remarks>
         IRewardedAdClient DequeueAd(string preloadId);
 
+        /// <summary>
+        /// Returns the ResponseInfo of an ad available for the given preload ID without
+        /// dequeuing it, or null if no ad is available.
+        /// </summary>
+        /// <param name="preloadId">
+        /// A string identifier used to preload the ads for that configuration.
+        /// </param>
+        /// <returns>
+        /// The ResponseInfo of the preloaded ad for the given preload ID, or null if no ad is available.
+        /// </returns>
+        IResponseInfoClient PeekAdResponseInfo(string preloadId);
+
         /// <summary>
         /// Get the number of ads available for the given preload ID.
         /// </summary>

source/plugin/Assets/GoogleMobileAds/Platforms/Android/AppOpenAdPreloaderClient.cs

@@ -70,6 +70,13 @@ public IAppOpenAdClient DequeueAd(string preloadId)
             return appOpenAdClient;
         }
 
+        public IResponseInfoClient PeekAdResponseInfo(string preloadId)
+        {
+            UnityEngine.Debug.LogError(
+                "PeekAdResponseInfo API is not available on the Legacy version of Google Mobile Ads Android SDK.");
+            return null;
+        }
+
         public int GetNumAdsAvailable(string preloadId)
         {
             return _unityAppOpenAdPreloader.Call<int>("getNumAdsAvailable", preloadId);

source/plugin/Assets/GoogleMobileAds/Platforms/Android/InterstitialAdPreloaderClient.cs

@@ -70,6 +70,13 @@ public IInterstitialClient DequeueAd(string preloadId)
             return interstitialClient;
         }
 
+        public IResponseInfoClient PeekAdResponseInfo(string preloadId)
+        {
+            UnityEngine.Debug.LogError(
+                "PeekAdResponseInfo API is not available on the Legacy version of Google Mobile Ads Android SDK.");
+            return null;
+        }
+
         public int GetNumAdsAvailable(string preloadId)
         {
             return _unityInterstitialPreloader.Call<int>("getNumAdsAvailable", preloadId);

source/plugin/Assets/GoogleMobileAds/Platforms/Android/NextGenAppOpenAdPreloaderClient.cs

@@ -62,6 +62,11 @@ public IAppOpenAdClient DequeueAd(string preloadId) {
       return appOpenAdClient;
     }
 
+    public IResponseInfoClient PeekAdResponseInfo(string preloadId) {
+      // TODO: Implement Android Peek API
+      return null;
+    }
+
     public int GetNumAdsAvailable(string preloadId) {
       return _unityAppOpenAdPreloader.Call<int>("getNumAdsAvailable", preloadId);
     }

source/plugin/Assets/GoogleMobileAds/Platforms/Android/NextGenInterstitialAdPreloaderClient.cs

@@ -63,6 +63,11 @@ public IInterstitialClient DequeueAd(string preloadId) {
       return interstitialAdClient;
     }
 
+    public IResponseInfoClient PeekAdResponseInfo(string preloadId) {
+      // TODO: Implement Android Peek API
+      return null;
+    }
+
     public int GetNumAdsAvailable(string preloadId) {
       return _unityInterstitialAdPreloader.Call<int>("getNumAdsAvailable", preloadId);
     }