Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Actualiza un lote de estados de ofertas de productos únicos.

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/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 productos únicos actualizadas.
productId

string

Obligatorio. Es el ID del producto único principal si todas las ofertas actualizadas pertenecen al mismo producto único. Si esta actualización por lotes abarca múltiples productos únicos, establece este campo como "-".
purchaseOptionId

string

Obligatorio. Es el ID de la opción de compra principal si todas las ofertas actualizadas pertenecen a la misma opción de compra. Si esta actualización por lotes abarca múltiples opciones de compra, establece este campo como "-".

Cuerpo de la solicitud

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

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

object (UpdateOneTimeProductOfferStateRequest)

Obligatorio. Es la lista de solicitudes de actualización, con 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 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Campos
oneTimeProductOffers[]

object (OneTimeProductOffer)

Es la lista de ofertas de productos únicos actualizadas, en el mismo orden que en la solicitud.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

UpdateOneTimeProductOfferStateRequest

Es un mensaje de solicitud para actualizar el estado de una oferta de producto único.

Representación JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // 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:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Activa una oferta. Una vez que se activa, la oferta está disponible para los usuarios, siempre y cuando se cumplan las condiciones.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Cancela una oferta. Una vez que se cancela, la oferta no está disponible para los usuarios. Se cancelarán los pedidos pendientes relacionados con esta oferta. Esta transición de estado es específica para pedidos por adelantado.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Desactiva una oferta. Una vez desactivada, la oferta ya no estará disponible para los usuarios. Esta transición de estado es específica para las ofertas con descuento.

CancelOneTimeProductOfferRequest

Es el mensaje de solicitud de offers.cancel.

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

string

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

string

Obligatorio. Es el ID del producto único principal de la oferta que se cancelará.
purchaseOptionId

string

Obligatorio. Es el ID de la opción de compra principal de la oferta que se cancelará.
offerId

string

Obligatorio. Es el ID de la oferta que se cancelará.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

Es el mensaje de solicitud de offers.deactivate.

Representación JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": 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 del producto único principal de la oferta que se desactivará.
purchaseOptionId

string

Obligatorio. ID de la opción de compra principal de la oferta que se desactivará.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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