Method: monetization.subscriptions.basePlans.migratePrices
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Migra los suscriptores de una o más cohortes de precios heredados al precio actual. Las solicitudes hacen que Google Play notifique a los suscriptores afectados. Solo se admiten hasta 250 cohortes de precios heredados simultáneas.
Solicitud HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
packageName |
string
Obligatorio. Es el nombre del paquete de la app superior. Debe ser igual al campo packageName del recurso Subscription.
|
productId |
string
Obligatorio. Es el ID de la suscripción que se actualizará. Debe ser igual al campo productId del recurso Subscription.
|
basePlanId |
string
Obligatorio. Es el ID único del plan básico en el que se actualizarán los precios.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Campos |
regionalPriceMigrations[] |
object (RegionalPriceMigrationConfig)
Obligatorio. Son los precios regionales que se actualizarán.
|
regionsVersion |
object (RegionsVersion)
Obligatorio. Es la versión de las regiones disponibles que se usan para regionalPriceMigrations.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
Opcional. La tolerancia de latencia para la propagación de esta actualización de producto. La configuración predeterminada es sensible a la latencia.
|
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/androidpublisher
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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,["- [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\nHTTP 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\nPath 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\nRequest 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\nResponse body\n\nIf successful, the response body is empty.\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
