Method: monetization.convertRegionPrices
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Calcola i prezzi delle regioni utilizzando il tasso di cambio della data corrente e i modelli di prezzi specifici del paese, in base al prezzo indicato nella richiesta per un insieme di regioni.
Richiesta HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
packageName |
string
Obbligatorio. Il nome del pacchetto dell'app.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"price": {
object (Money)
}
} |
| Campi |
price |
object (Money)
Il prezzo iniziale da cui convertire le altre regioni. Al netto delle imposte.
|
Corpo della risposta
Messaggio di risposta per monetization.convertRegionPrices.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Campi |
convertedRegionPrices |
map (key: string, value: object (ConvertedRegionPrice))
Mappa dal codice regione al prezzo della regione convertito. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
|
convertedOtherRegionsPrice |
object (ConvertedOtherRegionsPrice)
Prezzi di altre regioni convertiti in USD ed EUR, da utilizzare per i paesi in cui Google Play non supporta la valuta locale.
|
regionVersion |
object (RegionsVersion)
La versione della regione in cui sono stati generati i prezzi.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidpublisher
ConvertedRegionPrice
Un prezzo regionale convertito.
| Rappresentazione JSON |
{
"regionCode": string,
"price": {
object (Money)
},
"taxAmount": {
object (Money)
}
} |
| Campi |
regionCode |
string
Il codice della regione.
|
price |
object (Money)
Il prezzo convertito comprensivo di tasse.
|
taxAmount |
object (Money)
L'importo dell'imposta del prezzo convertito.
|
ConvertedOtherRegionsPrice
Prezzi di altre regioni convertiti.
| Rappresentazione JSON |
{
"usdPrice": {
object (Money)
},
"eurPrice": {
object (Money)
}
} |
| Campi |
usdPrice |
object (Money)
Prezzo in dollari statunitensi da utilizzare per la località "Altre regioni", escluse le tasse.
|
eurPrice |
object (Money)
Prezzo in EUR da utilizzare per la località "Altre regioni", escluse le tasse.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eThis endpoint calculates region prices using current exchange rates and country-specific pricing patterns.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires an initial price and the application's package name.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides converted prices for specified regions, including tax information and prices in USD/EUR for unsupported regions.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes gRPC Transcoding for the URL structure and needs \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],["This API endpoint calculates regional prices for an app based on a provided initial price. It uses a `POST` request to `convertRegionPrices`, including the app's package name as a path parameter. The request body specifies an initial, tax-exclusive `price`. The response includes `convertedRegionPrices`, a map of region codes to converted prices, and `convertedOtherRegionsPrice`, containing USD and EUR prices for regions without local currency support. The process also involves handling tax and authorization via an OAuth scope.\n"],null,["# Method: monetization.convertRegionPrices\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ConvertRegionPricesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ConvertedRegionPrice](#ConvertedRegionPrice)\n - [JSON representation](#ConvertedRegionPrice.SCHEMA_REPRESENTATION)\n- [ConvertedOtherRegionsPrice](#ConvertedOtherRegionsPrice)\n - [JSON representation](#ConvertedOtherRegionsPrice.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nCalculates 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.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|------------------------------------------|\n| `packageName` | `string` Required. The app package name. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------|\n| ``` { \"price\": { object (/android-publisher/api-ref/rest/v3/Money) } } ``` |\n\n| Fields ||\n|---------|--------------------------------------------------------------------------------------------------------------------------------|\n| `price` | `object (`[Money](/android-publisher/api-ref/rest/v3/Money)`)` The intital price to convert other regions from. Tax exclusive. |\n\n### Response body\n\nResponse message for monetization.convertRegionPrices.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"convertedRegionPrices\": { string: { object (/android-publisher/api-ref/rest/v3/monetization/convertRegionPrices#ConvertedRegionPrice) }, ... }, \"convertedOtherRegionsPrice\": { object (/android-publisher/api-ref/rest/v3/monetization/convertRegionPrices#ConvertedOtherRegionsPrice) }, \"regionVersion\": { object (/android-publisher/api-ref/rest/v3/RegionsVersion) } } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `convertedRegionPrices` | `map (key: string, value: object (`[ConvertedRegionPrice](/android-publisher/api-ref/rest/v3/monetization/convertRegionPrices#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\" }`. |\n| `convertedOtherRegionsPrice` | `object (`[ConvertedOtherRegionsPrice](/android-publisher/api-ref/rest/v3/monetization/convertRegionPrices#ConvertedOtherRegionsPrice)`)` Converted other regions prices in USD and EUR, to use for countries where Play doesn't support a country's local currency. |\n| `regionVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` The region version at which the prices were generated. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nConvertedRegionPrice\n--------------------\n\nA converted region price.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"regionCode\": string, \"price\": { object (/android-publisher/api-ref/rest/v3/Money) }, \"taxAmount\": { object (/android-publisher/api-ref/rest/v3/Money) } } ``` |\n\n| Fields ||\n|--------------|-------------------------------------------------------------------------------------------------------|\n| `regionCode` | `string` The region code of the region. |\n| `price` | `object (`[Money](/android-publisher/api-ref/rest/v3/Money)`)` The converted price tax inclusive. |\n| `taxAmount` | `object (`[Money](/android-publisher/api-ref/rest/v3/Money)`)` The tax amount of the converted price. |\n\nConvertedOtherRegionsPrice\n--------------------------\n\nConverted other regions prices.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"usdPrice\": { object (/android-publisher/api-ref/rest/v3/Money) }, \"eurPrice\": { object (/android-publisher/api-ref/rest/v3/Money) } } ``` |\n\n| Fields ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| `usdPrice` | `object (`[Money](/android-publisher/api-ref/rest/v3/Money)`)` Price in USD to use for the \"Other regions\" location exclusive of taxes. |\n| `eurPrice` | `object (`[Money](/android-publisher/api-ref/rest/v3/Money)`)` Price in EUR to use for the \"Other regions\" location exclusive of taxes. |"]]
