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.