Method: monetization.convertRegionPrices
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
قیمتهای منطقه را با استفاده از نرخ ارز امروز و الگوهای قیمتگذاری خاص کشور، بر اساس قیمت در درخواست مجموعهای از مناطق محاسبه میکند.
درخواست HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
packageName | string مورد نیاز. نام بسته برنامه |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"price": {
object (Money )
}
} |
فیلدها |
---|
price | object ( Money ) قیمت اولیه برای تبدیل مناطق دیگر. بدون مالیات |
بدن پاسخگو
پیام پاسخ برای monetization.convertRegionPrices.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
convertedRegionPrices | map (key: string, value: object ( ConvertedRegionPrice )) نقشه از کد منطقه به قیمت منطقه تبدیل شده است. یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } . |
convertedOtherRegionsPrice | object ( ConvertedOtherRegionsPrice ) قیمتهای مناطق دیگر را به دلار و یورو تبدیل کرد تا برای کشورهایی استفاده شود که Play از ارز محلی یک کشور پشتیبانی نمیکند. |
regionVersion | object ( RegionsVersion ) نسخه منطقه ای که قیمت ها در آن ایجاد شده است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
ConvertedRegionPrice
نمایندگی JSON |
---|
{
"regionCode": string,
"price": {
object (Money )
},
"taxAmount": {
object (Money )
}
} |
فیلدها |
---|
regionCode | string کد منطقه ای منطقه |
price | object ( Money ) قیمت تبدیل شده با احتساب مالیات. |
taxAmount | object ( Money ) مبلغ مالیات قیمت تبدیل شده. |
ConvertedOtherRegionsPrice
قیمت مناطق دیگر تبدیل شده است.
نمایندگی JSON |
---|
{
"usdPrice": {
object (Money )
},
"eurPrice": {
object (Money )
}
} |
فیلدها |
---|
usdPrice | object ( Money ) قیمت به دلار برای استفاده در مکان "مناطق دیگر" بدون مالیات. |
eurPrice | object ( Money ) قیمت به یورو برای استفاده در مکان "مناطق دیگر" بدون مالیات. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]