Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

Establece el campo billingTolerance en las solicitudes anidadas en PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT para alcanzar la capacidad de procesamiento máxima de 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. Indica la app principal (nombre del paquete) de las ofertas de suscripción actualizadas.

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

string

Obligatorio. El ID del producto de la suscripción superior, si todas las ofertas actualizadas pertenecen a la misma suscripción. Si esta solicitud abarca varias suscripciones, establece este campo en “-”. Se debe establecer.
basePlanId

string

Obligatorio. Corresponde al plan básico (ID) superior para el que se deben actualizar las ofertas. Se puede especificar como “-” para actualizar ofertas de varios 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. La lista de solicitud de actualización de hasta 100 elementos. Todas las solicitudes deben actualizar ofertas diferentes.

Cuerpo de la respuesta

Mensaje de respuesta para offers.diferentesStates.

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)

Lista actualizada de ofertas de suscripción.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

UpdateSubscriptionOfferStateRequest

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. Es el tipo de transición de estado que se debe aplicar. Se debe establecer exactamente una. Las direcciones (state_transition_type) solo pueden ser una de las siguientes opciones:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Activa una oferta. Una vez activada, la oferta estará disponible para suscriptores nuevos.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Desactiva una oferta. Una vez desactivada, la oferta dejará de estar disponible para los suscriptores nuevos, pero los suscriptores existentes mantendrán su suscripción

ActivateSubscriptionOfferRequest

Mensaje de solicitud para ActivateSubscriptionOffer.

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

string

Obligatorio. La app principal (nombre del paquete) de la oferta que se activará.
productId

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Mensaje de solicitud para offers.deactivate.

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

string

Obligatorio. La app principal (nombre del paquete) de la oferta que se desactivará.
productId

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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