Method: monetization.subscriptions.basePlans.batchUpdateStates

Ativa ou desativa planos básicos em uma ou várias assinaturas.

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: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) dos planos básicos atualizados.

productId

string

Obrigatório. O ID do produto da assinatura principal, se todos os planos básicos atualizados pertencerem à mesma assinatura. Se essa atualização em lote abranger várias assinaturas, defina este campo como "-". A definição é obrigatória.

Corpo da solicitação

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

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

object (UpdateBasePlanStateRequest)

Obrigatório. A lista de solicitações de atualização com até 100 elementos. Cada solicitação precisa atualizar um plano básico diferente.

Corpo da resposta

Mensagem de resposta para basePlans.batchUpdateStates.

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

Representação JSON
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Campos
subscriptions[]

object (Subscription)

A lista de assinaturas atualizadas. Ela vai corresponder às solicitações uma a uma, na mesma ordem.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

UpdateBasePlanStateRequest

Mensagem de solicitação para atualizar o estado do plano básico de uma assinatura.

Representação JSON
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // 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:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Ativa um plano básico. Depois de ativados, os planos básicos vão estar disponíveis para novos assinantes.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Desativa um plano básico. Depois de desativado, o plano básico vai ficar indisponível para novos assinantes, mas as assinaturas atuais continuam válidas.

ActivateBasePlanRequest

Mensagem de solicitação para ActivateBasePlan.

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

string

Obrigatório. O app principal (nome do pacote) do plano básico a ser ativado.

productId

string

Obrigatório. A assinatura principal (ID) do plano básico a ser ativado.

basePlanId

string

Obrigatório. O ID exclusivo do plano básico a ser ativado.

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.

DeactivateBasePlanRequest

Mensagem de solicitação para basePlans.deactivate.

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

string

Obrigatório. O app principal (nome do pacote) do plano básico a ser desativado.

productId

string

Obrigatório. A assinatura principal (ID) do plano básico a ser desativado.

basePlanId

string

Obrigatório. O ID exclusivo do plano básico a ser desativado.

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.