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 
 
) 
 } 
 }
    Fields
    price

    object ( Money )

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

    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: