Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Atualiza um lote de estados de oferta de assinatura.

Definir o campo latênciaTolerance nas solicitações aninhadas como PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT para atingir a capacidade máxima 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 pai (nome do pacote) das ofertas de assinatura atualizadas.

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

string

Obrigatório. O ID do produto da assinatura principal, se todas as ofertas atualizadas pertencerem à mesma assinatura. Se a solicitação abranger várias assinaturas, defina o campo como "-". Ele precisa ser definido.
basePlanId

string

Obrigatório. O plano básico pai (ID) em que as ofertas precisam ser atualizadas. Pode 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 de até 100 elementos. Todas as solicitações precisam atualizar ofertas diferentes.

Corpo da resposta

Mensagem de resposta para offer.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 atualizada de ofertas de assinatura.

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 vai ficar indisponível para novos assinantes, mas os assinantes atuais manterão a assinatura

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 pai (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 de latência para a propagação dessa atualização do produto. O padrão é sensível à latência.

DeactivateSubscriptionOfferRequest

Mensagem de solicitação para offer.deactivate.

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

string

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

string

Obrigatório. É a assinatura mãe (ID) da oferta a ser desativada.
basePlanId

string

Obrigatório. O plano básico pai (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 de latência para a propagação dessa atualização do produto. O padrão é sensível à latência.