Method: monetization.convertRegionPrices

  • This page details the convertRegionPrices method of the Android Publisher API, which calculates localized prices for app packages based on a given initial price, current exchange rates, and country-specific pricing.

  • The HTTP request to convert region prices is a POST request to a specific URL that includes the app package name as a path parameter.

  • The request body requires a price object representing the initial tax-exclusive price to be converted.

  • The response body includes convertedRegionPrices mapping region codes to converted prices, convertedOtherRegionsPrice for prices in USD and EUR for regions without local currency support, and the regionVersion used for the conversion.

  • Authorization for this method requires the https://www.googleapis.com/auth/androidpublisher OAuth scope.

Calculates the region prices, using today's exchange rate and country-specific pricing patterns, based on the price in the request for a set of regions.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

Required. The app package name.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "price": {
    object (Money)
  },
  "productTaxCategoryCode": string
}
Fields
price

object (Money)

The intital price to convert other regions from. Tax exclusive.
productTaxCategoryCode

string

Optional. Product tax category code in context. Product tax category determines the transaction tax rates applied to the product that will be factored into the price calculation.

If not set, tax rates for the default product tax category will be used.

Refer to the Help Center article for more information.

Response body

Response message for monetization.convertRegionPrices.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "convertedRegionPrices": {
    string: {
      object (ConvertedRegionPrice)
    },
    ...
  },
  "convertedOtherRegionsPrice": {
    object (ConvertedOtherRegionsPrice)
  },
  "regionVersion": {
    object (RegionsVersion)
  }
}
Fields
convertedRegionPrices

map (key: string, value: object (ConvertedRegionPrice))

Map from region code to converted region price.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
convertedOtherRegionsPrice

object (ConvertedOtherRegionsPrice)

Converted other regions prices in USD and EUR, to use for countries where Play doesn't support a country's local currency.
regionVersion

object (RegionsVersion)

The region version at which the prices were generated.

Authorization scopes

Requires the following OAuth scope:

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

ConvertedRegionPrice

A converted region price.

JSON representation 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "taxAmount": {
    object (Money)
  }
}
Fields
regionCode

string

The region code of the region.
price

object (Money)

The converted price tax inclusive.
taxAmount

object (Money)

The tax amount of the converted price.

ConvertedOtherRegionsPrice

Converted other regions prices.

JSON representation 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}
Fields
usdPrice

object (Money)

Price in USD to use for the "Other regions" location exclusive of taxes.
eurPrice

object (Money)

Price in EUR to use for the "Other regions" location exclusive of taxes.