Method: monetization.subscriptions.basePlans.migratePrices
ืงื ืืืจืื ืืคืื ืืขืืจืช ืืืกืคืื
ืืคืฉืจ ืืฉืืืจ ืืืกืืื ืชืืื ืขื ืกืื ืืืขืืคืืช ืฉืื.
ืืขืืจื ืฉื ืื ืืืื ืืงืืืฆืช ืืืืจืื ืงืืืืช ืืืช ืื ืืืชืจ ืืืืืจ ืื ืืืื. ืืืงืฉืืช ืืืื ืืืจืื ืืื ืฉืืขืจืืช Google Play ืชืืืืข ืืื ืืืื ืืจืืืื ืืืื. ืืฉ ืชืืืื ืืขื 250 ืงืืืฆืืช ืฉื ืืืืจืื ืงืืืืื ืื-ืืื ืืช.
ืืงืฉืช HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices
ืืืชืืืช ื-URL ื ืขืฉื ืฉืืืืฉ ืืชืืืืจ ืืืจืช ืงืืืื ืฉื gRPC.
ืคืจืืืจืื ืฉื ื ืชืื
| ืคืจืืืจืื |
packageName |
string
ืืืื. ืฉื ืืืืืื ืฉื ืืคืืืงืฆืืืช ืืืืจื. ืืฉื ืืืื ืืืืืช ืืื ืืฉืื packageName ืืืฉืื Subscription.
|
productId |
string
ืืืื. ืืืืื ืฉื ืืืื ืื ืฉืจืืฆืื ืืขืืื. ืืืื ืืืืืช ืฉืืื ืืฉืื productId ืืืฉืื 'ืืื ืื'.
|
basePlanId |
string
ืืืื. ืืืืื ืืืืืืื ืฉื ืืืื ืื ืืืกืืกื ืฉืื ืฆืจืื ืืขืืื ืืช ืืืืืจืื.
|
ืืืฃ ืืืงืฉื
ืืืฃ ืืืงืฉื ืืืื ื ืชืื ืื ืืืื ื ืืื:
| ืฉืืืช |
regionalPriceMigrations[] |
object (RegionalPriceMigrationConfig)
ืืืื. ืขืืืื ืืืืืจืื ืืืืืจืืื.
|
regionsVersion |
object (RegionsVersion)
ืืืื. ืืืจืกื ืฉื ืืืืืจืื ืืืืื ืื ืฉืืื ื ืขืฉื ืฉืืืืฉ ื-regionsPriceMigrations.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
ืื ืฉืื ืื ืืืคืฆืืื ืื. ืืืื ืืืจืื ืฉืืคืฉืจ ืืืืชืื ืขื ืืืคืฆื ืฉื ืขืืืื ืืืืฆืจ ืืื. ืืจืืจืช ืืืืื ืืื ืจืืืฉื ืืืื ืืืืืจ.
|
ืืืฃ ืืชืฉืืื
ืื ืืืืฆืืข ืืืื ืชืงืื, ืืืฃ ืืชืืืื ืืืื ืจืืง.
ืืืงืคื ืืืจืฉืืืช
ื ืืจืฉ ืืืงืฃ ืืืจืฉืืืช ืืื ืฉื OAuth:
https://www.googleapis.com/auth/androidpublisher
ืืื ืื ืฆืืื ืืืจืช, ืืชืืื ืฉื ืืฃ ืื ืืื ืืจืืฉืืื Creative Commons Attribution 4.0 ืืืืืืืืช ืืงืื ืื ืืจืืฉืืื Apache 2.0. ืืคืจืืื, ื ืืชื ืืขืืื ืืืืื ืืืช ืืืชืจ Google Developersโ.โ Java ืืื ืกืืื ืืกืืจื ืจืฉืื ืฉื ืืืจืช Oracle ื/ืื ืฉื ืืฉืืชืคืื ืืขืฆืืืืื ืฉืื.
ืขืืืื ืืืจืื: 2025-07-26 (ืฉืขืื UTC).
[[["ืืชืืื ืงื ืืืื ื","easyToUnderstand","thumb-up"],["ืืชืืื ืขืืจ ืื ืืคืชืืจ ืืขืื","solvedMyProblem","thumb-up"],["ืกืืื ืืืจืช","otherUp","thumb-up"]],[["ืืกืจืื ืื ืืืืข ืื ืคืจืืื","missingTheInformationINeed","thumb-down"],["ืืชืืื ืืืจืื ืืื ืื ืขื ืืืชืจ ืืื ืฉืืืื","tooComplicatedTooManySteps","thumb-down"],["ืืชืืื ืื ืขืืื ื","outOfDate","thumb-down"],["ืืขืื ืืชืจืืื","translationIssue","thumb-down"],["ืืขืื ืืืืืืืืช/ืืงืื","samplesCodeIssue","thumb-down"],["ืกืืื ืืืจืช","otherDown","thumb-down"]],["ืขืืืื ืืืจืื: 2025-07-26 (ืฉืขืื UTC)."],[[["\u003cp\u003eMigrates subscribers of one or more legacy price cohorts to the current subscription price, notifying affected subscribers via Google Play.\u003c/p\u003e\n"],["\u003cp\u003eSupports a maximum of 250 simultaneous legacy price cohorts for migration.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the package name, subscription ID, and base plan ID for the price migration.\u003c/p\u003e\n"],["\u003cp\u003eThe request body specifies regional price updates, the regions version, and an optional latency tolerance for the update.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"]]],["This content describes the process of migrating subscribers from legacy price cohorts to the current price using the Google Play API. This involves sending a `POST` request to a specific endpoint with parameters like `packageName`, `productId`, and `basePlanId`. The request body requires `regionalPriceMigrations` and `regionsVersion`, with an optional `latencyTolerance` parameter. Successful requests result in an empty response, and require `androidpublisher` authorization scope. Google Play notifies the affected subscribers of changes, with a limit of 250 simultaneous legacy cohorts.\n"],null,["# Method: monetization.subscriptions.basePlans.migratePrices\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nMigrates subscribers from one or more legacy price cohorts to the current price. Requests result in Google Play notifying affected subscribers. Only up to 250 simultaneous legacy price cohorts are supported.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. Package name of the parent app. Must be equal to the packageName field on the Subscription resource. |\n| `productId` | `string` Required. The ID of the subscription to update. Must be equal to the productId field on the Subscription resource. |\n| `basePlanId` | `string` Required. The unique base plan ID of the base plan to update prices on. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"regionalPriceMigrations\": [ { object (/android-publisher/api-ref/rest/v3/RegionalPriceMigrationConfig) } ], \"regionsVersion\": { object (/android-publisher/api-ref/rest/v3/RegionsVersion) }, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `regionalPriceMigrations[]` | `object (`[RegionalPriceMigrationConfig](/android-publisher/api-ref/rest/v3/RegionalPriceMigrationConfig)`)` Required. The regional prices to update. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the regionalPriceMigrations. |\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
