Method: monetization.subscriptions.basePlans.batchUpdateStates

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

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: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) 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 o campo como "-". Ele precisa ser definido.

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 de até 100 elementos. Todas as solicitações precisam atualizar planos básicos diferentes.

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. Essa lista corresponderá uma a uma solicitação, 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 de um plano básico de 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 ficar 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 os assinantes atuais manterão a assinatura.

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 mãe (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 de latência para a propagação dessa atualização do 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 pai (nome do pacote) do plano básico a ser desativado.
productId

string

Obrigatório. A assinatura mãe (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 de latência para a propagação dessa atualização do produto. O padrão é sensível à latência.