Method: monetization.subscriptions.basePlans.migratePrices

  • Migrates subscribers of one or more legacy price cohorts to the current subscription price, notifying affected subscribers via Google Play.

  • Supports a maximum of 250 simultaneous legacy price cohorts for migration.

  • Requires providing the package name, subscription ID, and base plan ID for the price migration.

  • The request body specifies regional price updates, the regions version, and an optional latency tolerance for the update.

  • Utilizes the https://www.googleapis.com/auth/androidpublisher authorization scope for access.

Migrates subscribers from one or more legacy price cohorts to the current price. Requests result in Google Play notifying affected subscribers. Only up to 250 simultaneous legacy price cohorts are supported.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

Required. Package name of the parent app. Must be equal to the packageName field on the Subscription resource.
productId

string

Required. The ID of the subscription to update. Must be equal to the productId field on the Subscription resource.
basePlanId

string

Required. The unique base plan ID of the base plan to update prices on.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "regionalPriceMigrations": [
    {
      object (RegionalPriceMigrationConfig)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Fields
regionalPriceMigrations[]

object (RegionalPriceMigrationConfig)

Required. The regional prices to update.
regionsVersion

object (RegionsVersion)

Required. The version of the available regions being used for the regionalPriceMigrations.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

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