Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

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. La app principal (nombre del paquete) 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 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. El plan básico (ID) superior para el que se deben actualizar las ofertas. Puede especificarse 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. Es la lista de solicitudes de actualización de hasta 100 elementos. Todas las solicitudes deben actualizar diferentes ofertas.

Cuerpo de la respuesta

Mensaje de respuesta para offers.firestoreStates.

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)

La lista actualizada de las ofertas de suscripción.

Alcances 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. El 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. Una vez que se active, la oferta estará disponible para nuevos suscriptores.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Desactiva una oferta. Una vez que se desactive, la oferta dejará de estar disponible para los suscriptores nuevos, pero los 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 superior (nombre del paquete) de la oferta que se activará.
productId

string

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

string

Obligatorio. Es el plan básico (ID) superior 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 de 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 superior (nombre del paquete) de la oferta que quieres desactivar.
productId

string

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

string

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

string

Obligatorio. Es el ID único de la oferta que se debe desactivar.
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.