Add the API to fetch underlying GMA Android or iOS SDK version.

PiperOrigin-RevId: 705625362

Author: Mobile Ads Developer Relations

ChangeLog.txt

@@ -1,5 +1,10 @@
 Google Mobile Ads Unity Plugin Change Log
 
+**************
+Version Next
+**************
+- Added GetPlatformVersion API to MobileAds class to be able to fetch the version info of the underlying GMA Android or iOS SDK.
+
 **************
 Version 9.4.0
 **************

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

@@ -206,6 +206,22 @@ public static void DisableSDKCrashReporting()
             Instance.client.DisableSDKCrashReporting();
         }
 
+        /// <summary>
+        /// Gets the underlying Google Mobile Ads Android or iOS SDK version for the active
+        /// platform.
+        /// </summary>
+        /// <remarks>
+        /// When running on the Unity editor, this method returns the Google Mobile Ads Unity SDK
+        /// version.
+        /// </remarks>
+        /// <returns>
+        /// The Google Mobile Ads Android or iOS SDK version for the platform the app is running on.
+        /// </returns>
+        public static Version GetPlatformVersion()
+        {
+            return Instance.client.GetSDKVersion();
+        }
+
         /// <summary>
         /// Preloads ads for the given configurations.
         /// </summary>

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

@@ -66,6 +66,9 @@ void Preload(List<PreloadConfiguration> configurations,
         // Set Global Request Configuration to Mobile Ads SDK
         void SetRequestConfiguration(RequestConfiguration requestConfiguration);
 
+        // Returns the Mobile Ads SDK version.
+        Version GetSDKVersion();
+
         // Get Mobile Ads SDK's Global Request Configuration
         RequestConfiguration GetRequestConfiguration();
 

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

@@ -137,6 +137,15 @@ public int GetDeviceSafeWidth()
             return Utils.GetScreenWidth();
         }
 
+        public Version GetSDKVersion()
+        {
+            AndroidJavaClass mobileAdsClass = new AndroidJavaClass(Utils.MobileAdsClassName);
+            AndroidJavaObject androidSDKVersion =
+                mobileAdsClass.CallStatic<AndroidJavaObject>("getVersion");
+            string versionString = androidSDKVersion.Call<string>("toString");
+            return new Version(versionString);
+        }
+
         #region Callbacks from OnInitializationCompleteListener.
 
         public void onInitializationComplete(AndroidJavaObject initStatus)

source/plugin/Assets/GoogleMobileAds/Platforms/Unity/MobileAdsClient.cs

@@ -128,6 +128,11 @@ public int GetDeviceSafeWidth()
             return 0;
         }
 
+        public Version GetSDKVersion()
+        {
+            return new Version(AdRequest.Version);
+        }
+
         public void CreateBannerView(string adUnitId, AdSize adSize, AdPosition position) {}
 
         public void CreateBannerView(string adUnitId, AdSize adSize, int positionX, int positionY) {}

source/plugin/Assets/GoogleMobileAds/Platforms/iOS/Externs.cs

@@ -156,6 +156,9 @@ internal static extern void GAMUSetPublisherProvidedID(IntPtr request,
         [DllImport("__Internal")]
         internal static extern void GADUSetPreloadConfigurationBufferSize(IntPtr preloadConfiguration, uint bufferSize);
 
+        [DllImport("__Internal")]
+        internal static extern string GADUMobileAdsVersion();
+
         [DllImport("__Internal")]
         internal static extern IntPtr GADUCreateRequestConfiguration();
 

source/plugin/Assets/GoogleMobileAds/Platforms/iOS/MobileAdsClient.cs

@@ -105,6 +105,12 @@ public int GetDeviceSafeWidth()
             return Externs.GADUDeviceSafeWidth();
         }
 
+        public Version GetSDKVersion()
+        {
+            string iOSVersion = Externs.GADUMobileAdsVersion();
+            return new Version(iOSVersion);
+        }
+
         public void Preload(List<PreloadConfiguration> configurations,
                             Action<PreloadConfiguration> onAdAvailable,
                             Action<PreloadConfiguration> onAdsExhausted)

source/plugin/Assets/Plugins/iOS/GADUInterface.m

@@ -218,6 +218,12 @@ void GADUDisableSDKCrashReporting() {
   [GADMobileAds.sharedInstance disableSDKCrashReporting];
 }
 
+// Returns the version number of the GMA iOS SDK.
+const char* GADUMobileAdsVersion() {
+  GADVersionNumber version = [GADMobileAds.sharedInstance versionNumber];
+  return cStringCopy(GADGetStringFromVersionNumber(version).UTF8String);
+}
+
 float GADUDeviceScale() { return UIScreen.mainScreen.scale; }
 
 void GADUSetIntegerPreference(const char *key, NSInteger value) {