Method: monetization.subscriptions.basePlans.migratePrices

Migra a los suscriptores que reciben un precio de suscripción histórico al precio ofrecido actualmente para la región especificada. Las solicitudes harán que las notificaciones de cambio de precio se envíen a los usuarios que actualmente reciben un precio histórico anterior a la marca de tiempo proporcionada. Los suscriptores que no acepten el precio nuevo verán su suscripción finalizada en la próxima renovación.

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. Nombre del paquete de la app superior. Debe ser igual al campo packageName en el recurso de suscripción.

productId

string

Obligatorio. Es el ID de la suscripción que se actualizará. Debe ser igual al campo productId en el recurso de suscripción.

basePlanId

string

Obligatorio. 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:

Representación JSON
{
  "regionalPriceMigrations": [
    {
      object (RegionalPriceMigrationConfig)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Campos
regionalPriceMigrations[]

object (RegionalPriceMigrationConfig)

Obligatorio. Los precios regionales que se actualizarán.

regionsVersion

object (RegionsVersion)

Obligatorio. La versión de las regiones disponibles que se usan para el regionalPricePriceMigrations.

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

RegionalPriceMigrationConfig

Configuración de una migración de precios.

Representación JSON
{
  "regionCode": string,
  "oldestAllowedPriceVersionTime": string,
  "priceIncreaseType": enum (PriceIncreaseType)
}
Campos
regionCode

string

Obligatorio. Es el código de región al que se aplica esta configuración, según lo define la norma ISO 3166-2, p.ej., “US”.

oldestAllowedPriceVersionTime

string (Timestamp format)

Obligatorio. Es el horario límite para pagar los precios históricos que los suscriptores pueden seguir pagando. Los suscriptores que tienen un precio creado antes de esta hora límite migrarán al precio ofrecido actualmente. Estos recibirán una notificación de que pagarán un precio diferente. Los suscriptores que no acepten el precio nuevo verán su suscripción finalizada en la próxima renovación.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

priceIncreaseType

enum (PriceIncreaseType)

Opcional. El comportamiento que desea que llame el usuario para ver cuando haya un aumento de precio durante la migración Si no la estableces, el comportamiento se establecerá de forma predeterminada en PRICE_INCREASE_TYPE_OPT_IN. Ten en cuenta que la primera migración para aumentar el precio de la inhabilitación de cada app debe iniciarse en Play Console.

Tipo de aumento de precio

Es el tipo de migración de precios.

Enumeradores
PRICE_INCREASE_TYPE_UNSPECIFIED Estado sin especificar.
PRICE_INCREASE_TYPE_OPT_IN Los usuarios aumentarán los precios si habilitan la opción.
PRICE_INCREASE_TYPE_OPT_OUT El aumento de precio se presentará a los usuarios cuando no la acepten.