Method: monetization.convertRegionPrices
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tính toán giá theo khu vực, sử dụng tỷ giá hối đoái của ngày hôm nay và mô hình định giá theo quốc gia, dựa trên giá trong yêu cầu cho một nhóm khu vực.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
packageName |
string
Bắt buộc. Tên gói ứng dụng.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"price": {
object (Money )
}
} |
Trường |
price |
object (Money )
Giá ban đầu để chuyển đổi các khu vực khác. Chưa bao gồm thuế.
|
Nội dung phản hồi
Thông báo phản hồi cho monetization.convertRegionPrices.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Trường |
convertedRegionPrices |
map (key: string, value: object (ConvertedRegionPrice ))
Liên kết từ mã khu vực đến giá khu vực đã chuyển đổi. Một đối tượng chứa danh sách các cặp "key": value . Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
convertedOtherRegionsPrice |
object (ConvertedOtherRegionsPrice )
Giá đã quy đổi sang USD và EUR cho các khu vực khác để sử dụng cho những quốc gia mà Play không hỗ trợ nội tệ của quốc gia đó.
|
regionVersion |
object (RegionsVersion )
Phiên bản theo khu vực mà giá được tạo.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
ConvertedRegionPrice
Giá theo khu vực đã quy đổi.
Biểu diễn dưới dạng JSON |
{
"regionCode": string,
"price": {
object (Money )
},
"taxAmount": {
object (Money )
}
} |
Trường |
regionCode |
string
Mã vùng của khu vực.
|
price |
object (Money )
Giá đã chuyển đổi, bao gồm cả thuế.
|
taxAmount |
object (Money )
Số tiền thuế của giá đã chuyển đổi.
|
ConvertedOtherRegionsPrice
Giá đã quy đổi cho các khu vực khác.
Biểu diễn dưới dạng JSON |
{
"usdPrice": {
object (Money )
},
"eurPrice": {
object (Money )
}
} |
Trường |
usdPrice |
object (Money )
Giá tính bằng USD để sử dụng cho vị trí "Các khu vực khác", không bao gồm thuế.
|
eurPrice |
object (Money )
Giá tính bằng EUR để sử dụng cho vị trí "Các khu vực khác", chưa bao gồm thuế.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]