Posted by Rejane Franca, Product Manager and Serge Beauchamp, Software Engineer at Google Play
Last year, we
introduced new capabilities for subscriptions
on Google Play, giving you more flexibility and control when it comes to growing and retaining your subscribers. The enhanced developer experience enabled by the
monetization.subscriptions APIs
, separates your subscription products -
what
you sell - from
how
you
sell them, allowing you to configure multiple base plans and offers for each subscription. The new model is designed to reduce the complexity and overhead of
managing your product configuration
- this means:
- The
subscription
now defines the benefits and other metadata for the product you are selling, regardless of how the user pays.
- Each
base plan
within a subscription defines the base price for a specific billing period and plan renewal type.
- In addition to auto-renewing plans, you can
sell prepaid plans
that allow users access to pay a fixed amount of time, and then top-up as desired. With prepaid plans, reach users in regions where pay-as-you-go is standard or provide an alternative for users not ready to purchase an auto-renewing plan.
- Offers
build on the base plan, making it easier to define alternative pricing for eligible users throughout the monetization lifecycle. They can be used to acquire new subscribers, incentivize upgrades, or retain existing subscribers.
Monetization.subscriptions APIs will replace InAppProducts API for subscription catalog management
Starting on January 1, 2024, all new apps must use monetization.subscriptions APIs
for managing your subscriptions catalog.
Existing apps will have until May 1, 2024 to migrate
to the new monetization.subscriptions APIs, at which point support for using the InAppProducts API for managing your subscriptions catalog will end completely.
Starting this month, if we detect that your app has used the InAppProducts API to manage your subscriptions within the last 7 days, you will start seeing a reminder in Play Console to migrate over to monetization.subscriptions APIs.
Additionally, if your app is not using the latest version of Play Billing Library, you’ll need to
upgrade to version 5.0 or later
before November of this year in order to publish updates to your app.
If you continue to use the InAppProduct API while support is still available, the subscription SKUs you create will be automatically converted into the new model following the backward compatible structure represented below with limited access to new features. Learn more about converted subscriptions
here
.
No changes to selling in-app items with the InAppProducts API
This deprecation will only impact the
InAppProducts API
when used to manage your subscription product catalog in Play Console. All apps can continue using the InAppProducts API to manage one-time products. The Play Billing Library and Subscription Purchase APIs will not be impacted. Note that both InAppProducts API and monetization.subscriptions APIs are for managing your subscription catalog on Play from your backend, and should not be called directly as part of any in-app flows.
Start your migration to the monetization.subscriptions APIs
If you use the Google Play Developer API client libraries -
available for
Java
,
Python
, and other popular languages
- we recommend upgrading to the latest versions, which already include the monetization.subscriptions APIs. Base plans can be managed with the
monetization.subscription.basePlans API
, and introductory pricing and free trials can be managed as offers with the
monetization.subscriptions.basePlans.offers API
.
To use the new monetization.subscriptions APIs with existing subscriptions, make sure that you’ve
made your pre-existing subscriptions editable
in Play Console.
Start maximizing the latest
subscription capabilities
available with the monetization.subscriptions APIs. Learn more by visiting the
Help Center
,
getting started guide
,
documentation
, and
sample app
.