# Android deprecated APIs

> Identify deprecated Unity Ads SDK classes for Android (java), as well as the replacement and removal versions.

## Android deprecated classes (java)

The following API classes are deprecated or obsolete for the Android SDK:

| **API to be removed**                                                                                                                                                                  | **Deprecated in version** | **What to use instead**                                                                                 | **Removed in version** | **Depreciation reason**                                  |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------- | -------------------------------------------------------- |
| `initialize(final Activity activity, final String gameId, final IUnityAdsListener listener)`                                                                                           | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId)`                                                                                                                             | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final IUnityAdsInitializationListener initializationListener)`                                                               | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final IUnityAdsListener listener, final boolean testMode)`                                                                   | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final boolean testMode)`                                                                                                     | 3.4.0                     | Use the consolidated`initialize` method signature.                                                      | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final boolean testMode, final IUnityAdsInitializationListener initializationListener)`                                       | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final IUnityAdsListener listener, final boolean testMode, final boolean enablePerPlacementLoad)`                             | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad)`                                                               | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Activity activity, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad, final IUnityAdsInitializationListener initializationListener)` | 3.4.0                     | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Context context, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad)`                                                                 | NA                        | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `initialize(final Context context, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad, final IUnityAdsInitializationListener initializationListener)`   | NA                        | Use the consolidated `initialize` method signature.                                                     | 4.0.0                  | Replaced by consolidated `initialize` API.               |
| `setListener(IUnityAdsListener listener)`                                                                                                                                              | 3.4.0                     | Use the `initialize`, `load`, and `show` methods' listeners.                                            | 4.0.0                  | Improved callbacks for `Show` and `Load` APIs.           |
| `getListener()`                                                                                                                                                                        | 3.4.0                     | Use the `initialize`, `load`, and `show` methods' listeners.                                            | 4.0.0                  | Improved callbacks for `Show` and `Load` APIs.           |
| `addListener(IUnityAdsListener listener)`                                                                                                                                              | NA                        | Use the `initialize`, `load`, and `show` methods' listeners.                                            | 4.0.0                  | Improved callbacks for `Show` and `Load` APIs.           |
| `removeListener(IUnityAdsListener listener)`                                                                                                                                           | NA                        | Use the `initialize`, `load`, and `show` methods' listeners.                                            | 4.0.0                  | Improved callbacks for `Show` and `Load` APIs.           |
| `isReady()`                                                                                                                                                                            | 3.7.1                     | Use the updated `load` method signature to access load callbacks.                                       | 4.0.0                  | Introduced a `Load` API with callbacks.                  |
| `isReady(String placementId)`                                                                                                                                                          | 3.7.1                     | Use the updated `load` method signature to access load callbacks.                                       | 4.0.0                  | Introduced a `Load` API with callbacks.                  |
| `getPlacementState()`                                                                                                                                                                  | NA                        | No direct replacement.                                                                                  | 4.0.0                  | No longer required with `Load` and `Show` functionality. |
| `show(final Activity activity)`                                                                                                                                                        | 3.7.0                     | Use the updated `show` method signature to access show callbacks.                                       | 4.0.0                  | Introduced a `Show` API with callbacks.                  |
| `IUnityAdsListener`                                                                                                                                                                    | NA                        | Use the `IUnityAdsInitializationListener`, `IUnityAdsLoadListener`, `IUnityAdsShowListener` interfaces. | 4.0.0                  | Improved callbacks for `Show` and `Load` APIs.           |
| `IUnityAdsExtendedListener`                                                                                                                                                            | NA                        | Use the `IUnityAdsShowListener` interface.                                                              | 4.0.0                  | Improved callbacks for `Show` and `Load` APIs.           |
| `com.unity3d.services.monetization`                                                                                                                                                    | NA                        | Use the `UnityAds.java` API.                                                                            | 4.0.0                  | Legacy `Monetization` API not supported.                 |
| `com.unity3d.services.purchasing`                                                                                                                                                      | NA                        | No direct replacement.                                                                                  | 4.0.0                  | Legacy `Monetization` API not supported.                 |