Method: monetization.subscriptions.create

  • This API endpoint is used to create a new subscription within a specified Android application.

  • The request is made using a POST HTTP method to a URL that includes the package name of the application.

  • Required parameters for creating a subscription include the application's package name, a unique product ID for the subscription, and the version of available regions being used.

  • The request and response bodies both contain instances of the Subscription resource, and authorization requires a specific Google API scope.

Creates a new subscription. Newly added base plans will remain in draft state until activated.

HTTP request

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

Required. The parent app (package name) for which the subscription should be created. Must be equal to the packageName field on the Subscription resource.

Query parameters

Parameters
productId

string

Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the productId field on the Subscription resource.

regionsVersion

object (RegionsVersion)

Required. The version of the available regions being used for the subscription.

Request body

The request body contains an instance of Subscription.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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