Method: monetization.subscriptions.basePlans.batchUpdateStates

Attiva o disattiva i piani base su uno o più abbonamenti.

Imposta il campo latencyTolerance nelle richieste nidificate su PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT per ottenere il throughput massimo degli aggiornamenti.

Richiesta HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

Obbligatorio. L'app principale (nome del pacchetto) dei piani base aggiornati.

productId

string

Obbligatorio. L'ID prodotto dell'abbonamento principale, se tutti i piani base aggiornati appartengono allo stesso abbonamento. Se questo aggiornamento collettivo interessa più abbonamenti, imposta questo campo su "-". Deve essere impostato.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "requests": [
    {
      object (UpdateBasePlanStateRequest)
    }
  ]
}
Campi
requests[]

object (UpdateBasePlanStateRequest)

Obbligatorio. L'elenco delle richieste di aggiornamento di massimo 100 elementi. Tutte le richieste devono aggiornare piani base diversi.

Corpo della risposta

Messaggio di risposta per basePlans.batchUpdateStates.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Campi
subscriptions[]

object (Subscription)

L'elenco degli abbonamenti aggiornati. Questo elenco corrisponderà alle richieste una a una, nello stesso ordine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

UpdateBasePlanStateRequest

Messaggio di richiesta per aggiornare lo stato di un piano base dell'abbonamento.

Rappresentazione 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.
}
Campi
Campo unione state_transition_type. Il tipo di transizione di stato da applicare. Deve essere impostato esattamente un valore. state_transition_type può essere solo uno dei seguenti:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Attiva un piano base. Una volta attivati, i piani base saranno disponibili per i nuovi abbonati.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Disattiva un piano base. Una volta disattivato, il piano base non sarà più disponibile per i nuovi abbonati, ma gli abbonati esistenti manterranno il proprio abbonamento

ActivateBasePlanRequest

Messaggio di richiesta per ActivateBasePlan.

Rappresentazione JSON
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campi
packageName

string

Obbligatorio. L'app principale (nome del pacchetto) del piano base da attivare.

productId

string

Obbligatorio. L'abbonamento principale (ID) del piano base da attivare.

basePlanId

string

Obbligatorio. L'ID univoco del piano base da attivare.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Facoltativo. La tolleranza alla latenza per la propagazione di questo aggiornamento del prodotto. Il valore predefinito è sensibile alla latenza.

DeactivateBasePlanRequest

Messaggio di richiesta per basePlans.deactivate.

Rappresentazione JSON
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campi
packageName

string

Obbligatorio. L'app principale (nome del pacchetto) del piano base da disattivare.

productId

string

Obbligatorio. L'abbonamento principale (ID) del piano base da disattivare.

basePlanId

string

Obbligatorio. L'ID univoco del piano base da disattivare.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Facoltativo. La tolleranza alla latenza per la propagazione di questo aggiornamento del prodotto. Il valore predefinito è sensibile alla latenza.