Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Atualiza um lote de estados de oferta de assinatura.

Defina o campo latencyTolerance em solicitações aninhadas como PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT para atingir a máxima capacidade de processamento de atualização.

Solicitação HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/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 assinatura atualizadas.

Precisa ser igual ao campo packageName em todos os recursos SubscriptionOffer atualizados.
productId

string

Obrigatório. O ID do produto da assinatura principal, se todas as ofertas atualizadas pertencerem à mesma assinatura. Se essa solicitação abranger várias assinaturas, defina este campo como "-". A definição é obrigatória.
basePlanId

string

Obrigatório. O plano básico principal (ID) das ofertas que precisam ser atualizadas. Precisa ser especificado como "-" para atualizar ofertas de vários planos básicos.

Corpo da solicitação

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

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

object (UpdateSubscriptionOfferStateRequest)

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

Corpo da resposta

Mensagem de resposta para offers.batchUpdateStates.

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

Representação JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Campos
subscriptionOffers[]

object (SubscriptionOffer)

A lista de ofertas de assinatura atualizadas.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

UpdateSubscriptionOfferStateRequest

Mensagem de solicitação para atualizar o estado de uma oferta de assinatura.

Representação 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ão state_transition_type. O tipo de transição de estado a ser aplicado. É necessário definir exatamente um. state_transition_type pode ser apenas de um dos tipos a seguir:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Ativa uma oferta. Depois de ativada, a oferta vai ficar disponível para novos assinantes.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Desativa uma oferta. Depois de desativada, a oferta fica indisponível para novos assinantes, mas as assinaturas atuais continuam válidas.

ActivateSubscriptionOfferRequest

Mensagem de solicitação para ActivateSubscriptionOffer.

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

string

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

string

Obrigatório. A assinatura principal (ID) da oferta a ser ativada.
basePlanId

string

Obrigatório. O plano básico principal (ID) da oferta a ser ativada.
offerId

string

Obrigatório. O ID exclusivo da oferta a ser ativada.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Mensagem de solicitação para offers.deactivate.

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

string

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

string

Obrigatório. A assinatura principal (ID) da oferta a ser desativada.
basePlanId

string

Obrigatório. O plano básico principal (ID) da oferta a ser desativada.
offerId

string

Obrigatório. O ID exclusivo da oferta a ser desativada.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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