Method: monetization.subscriptions.basePlans.offers.create

AI-generated Key Takeaways

• Creates a new subscription offer for auto-renewing base plans, initially in DRAFT state until activated.

• Uses an HTTP POST request to https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers with specified path and query parameters.

• Requires providing a SubscriptionOffer object in the request body, detailing the offer's specifics.

• Upon success, the response body returns the newly created SubscriptionOffer object.

• Needs authorization with the https://www.googleapis.com/auth/androidpublisher OAuth scope.

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Creates a new subscription offer. Only auto-renewing base plans can have subscription offers. The offer state will be DRAFT until it is activated.

HTTP request

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName	string Required. The parent app (package name) for which the offer should be created. Must be equal to the packageName field on the Subscription resource.
productId	string Required. The parent subscription (ID) for which the offer should be created. Must be equal to the productId field on the SubscriptionOffer resource.
basePlanId	string Required. The parent base plan (ID) for which the offer should be created. Must be equal to the basePlanId field on the SubscriptionOffer resource.

Query parameters

Parameters
offerId	string Required. The ID to use for the offer. For the requirements on this format, see the documentation of the offerId field on the SubscriptionOffer resource.
regionsVersion	object (RegionsVersion) Required. The version of the available regions being used for the subscriptionOffer.

Request body

The request body contains an instance of SubscriptionOffer.

Response body

If successful, the response body contains a newly created instance of SubscriptionOffer.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/androidpublisher