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

Parámetros
packageName

string

Obligatorio. Es el nombre del paquete de la app principal donde están 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 permiso 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
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
Campos
Es el tipo de transición de estado que se aplicará. Se debe establecer exactamente uno. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
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 que se desactiva, la oferta ya no está disponible para los usuarios. Esta transición de estado es específica para las ofertas con descuento y de recompensas de juegos.

Fin de los campos mutuamente excluyentes.

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 donde está 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 un mensaje de solicitud para 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. Es el 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.