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
필수 항목입니다. 상위 앱의 패키지 이름입니다. Subscription 리소스의 packageName 필드와 동일해야 합니다.
|
productId |
string
필수 항목입니다. 업데이트할 정기 결제의 ID입니다. 구독 리소스의 productId 필드와 같아야 합니다.
|
basePlanId |
string
필수 항목입니다. 가격을 업데이트할 기본 요금제의 고유 기본 요금제 ID입니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| 필드 |
regionalPriceMigrations[] |
object (RegionalPriceMigrationConfig)
필수 항목입니다. 업데이트할 지역별 가격입니다.
|
regionsVersion |
object (RegionsVersion)
필수 항목입니다. regionalPriceMigrations에 사용되는 가용 지역의 버전입니다.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용치입니다. 기본값은 latency-sensitive입니다.
|
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidpublisher
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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`"]]
