Method: monetization.subscriptions.basePlans.migratePrices
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將訂閱者從一或多個舊版價格同類群組遷移至目前價格。這類要求會導致 Google Play 通知受影響的訂閱者。最多只能同時支援 250 個舊版價格同類群組。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
packageName |
string
必要欄位。父項應用程式的套件名稱。必須等於訂閱資源中的 packageName 欄位。
|
productId |
string
必要欄位。要更新的訂閱項目 ID。必須等於訂閱資源中的 productId 欄位。
|
basePlanId |
string
必要欄位。要更新價格的基本方案專屬 ID。
|
要求主體
要求主體的資料會採用以下結構:
欄位 |
regionalPriceMigrations[] |
object (RegionalPriceMigrationConfig )
必要欄位。要更新的區域價格。
|
regionsVersion |
object (RegionsVersion )
必要欄位。用於區域價格遷移的可用區域版本。
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
選用設定。這項產品更新傳播的延遲時間容忍度。預設為「延遲敏感」。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidpublisher
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\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`"]]