Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Atualiza um lote de estados de oferta de produto único.

Solicitação HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
packageName

string

Obrigatório. O app principal (nome do pacote) das ofertas de produto único atualizadas.
productId

string

Obrigatório. O ID do produto único principal, se todas as ofertas atualizadas forem do mesmo produto único. Se essa atualização em lote abranger vários produtos únicos, defina este campo como "-".
purchaseOptionId

string

Obrigatório. O ID da opção de compra principal, se todas as ofertas atualizadas forem da mesma opção de compra. Se essa atualização em lote abranger várias opções de compra, defina este campo como "-".

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferStateRequest)
    }
  ]
}
Campos
requests[]

object (UpdateOneTimeProductOfferStateRequest)

Obrigatório. A lista de solicitação de atualização com até 100 elementos. Cada solicitação precisa atualizar uma oferta diferente.

Corpo da resposta

Mensagem da resposta para offers.batchUpdateStates.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Campos
oneTimeProductOffers[]

object (OneTimeProductOffer)

A lista atualizada de ofertas de produtos únicos, na mesma ordem da solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

UpdateOneTimeProductOfferStateRequest

Mensagem de solicitação para atualizar o estado da oferta de produto único.

Representação 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
O tipo de transição de estado a ser aplicado. É necessário definir exatamente um. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Ativa uma oferta. Uma vez ativada, a oferta fica disponível para usuários desde que as condições sejam atendidas.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Cancela uma oferta. Uma vez cancelada, a oferta não fica disponível para os usuários. Quaisquer pedidos pendentes relacionados à oferta vão ser cancelados. Essa transição de estado é específica para pré-encomendas.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Desativa uma oferta. Depois de desativada, a oferta não fica mais disponível para os usuários. Essa transição de estado é específica para ofertas com desconto e de prêmios em jogos.
Fim dos campos mutuamente exclusivos.

CancelOneTimeProductOfferRequest

Mensagem da solicitação de offers.cancel.

Representação JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campos
packageName

string

Obrigatório. O app principal (nome do pacote) da oferta a ser cancelada.
productId

string

Obrigatório. O produto único principal (ID) da oferta a ser cancelada.
purchaseOptionId

string

Obrigatório. A opção de compra principal (ID) da oferta a ser cancelada.
offerId

string

Obrigatório. O ID da oferta a ser cancelada.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcional. A tolerância à latência para a propagação desta atualização. O padrão é "sensível à latência".

DeactivateOneTimeProductOfferRequest

Mensagem de solicitação para "offers.deactivate".

Representação JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campos
packageName

string

Obrigatório. O app principal (nome do pacote) da oferta que será desativada.
productId

string

Obrigatório. O produto único principal (ID) da oferta que será desativada.
purchaseOptionId

string

Obrigatório. A opção de compra principal (ID) da oferta que será desativada.
offerId

string

Obrigatório. O ID da oferta que será desativada.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcional. A tolerância à latência para a propagação desta atualização. O padrão é "sensível à latência".