Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Actualiza un lote de estados de ofertas de suscripción.

Establece el campo latencyTolerance de las solicitudes anidadas en PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT para lograr la máxima capacidad de procesamiento de la actualización.

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates

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 principal de las ofertas de suscripción actualizadas.

Debe ser igual al campo packageName en todos los recursos SubscriptionOffer actualizados.
productId

string

Obligatorio. Es el ID del producto de la suscripción principal si todas las ofertas actualizadas pertenecen a la misma suscripción. Si esta solicitud abarca múltiples suscripciones, establece este campo como "-", ya que se debe definir un valor.
basePlanId

string

Obligatorio. Es el ID del plan básico principal para el que se deben actualizar las ofertas. Se puede especificar como "-" para actualizar las ofertas de múltiples planes básicos.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object (UpdateSubscriptionOfferStateRequest)
    }
  ]
}
Campos
requests[]

object (UpdateSubscriptionOfferStateRequest)

Obligatorio. Es la lista de solicitudes de actualización de hasta 100 elementos. Todas las solicitudes deben actualizar diferentes ofertas.

Cuerpo de la respuesta

Es el mensaje de respuesta para offers.batchUpdateStates.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Campos
subscriptionOffers[]

object (SubscriptionOffer)

Es la lista de ofertas de suscripción actualizadas.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/androidpublisher

UpdateSubscriptionOfferStateRequest

Es un mensaje de solicitud para actualizar el estado de una oferta de suscripción.

Representación JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Campos
Campo de unión state_transition_type. Tipo de transición de estado que se aplicará. Se debe establecer exactamente uno. Las direcciones (state_transition_type) solo pueden ser una de las siguientes opciones:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Activa una oferta. Cuando esto ocurre, la oferta queda disponible para nuevos suscriptores.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Desactiva una oferta. Cuando esto ocurre, la oferta deja de estar disponible para nuevos suscriptores, pero se mantienen las suscripciones existentes.

ActivateSubscriptionOfferRequest

Es un mensaje de solicitud para ActivateSubscriptionOffer.

Representación JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campos
packageName

string

Obligatorio. Es el nombre del paquete de la app principal de la oferta que se activará.
productId

string

Obligatorio. Es el ID de la suscripción principal de la oferta que se activará.
basePlanId

string

Obligatorio. Es el ID del plan básico principal de la oferta que se activará.
offerId

string

Obligatorio. Es el ID único de la oferta que se activará.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcional. Es la tolerancia de latencia para la propagación de esta actualización de producto. La configuración predeterminada es sensible a la latencia.

DeactivateSubscriptionOfferRequest

Es un mensaje de solicitud para offers.deactivate.

Representación JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campos
packageName

string

Obligatorio. Es el nombre del paquete de la app principal de la oferta que se desactivará.
productId

string

Obligatorio. Es el ID de la suscripción principal de la oferta que se desactivará.
basePlanId

string

Obligatorio. Es el ID del plan básico principal de la oferta que se desactivará.
offerId

string

Obligatorio. Es el ID único de la oferta que se desactivará.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcional. Es la tolerancia de latencia para la propagación de esta actualización de producto. La configuración predeterminada es sensible a la latencia.