Method: monetization.subscriptions.basePlans.batchUpdateStates

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

Imposta il campo latenzaTolerance per le richieste nidificate su PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT per raggiungere la velocità effettiva di aggiornamento massima.

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 l'aggiornamento batch interessa più sottoscrizioni, 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 con un massimo di 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 delle iscrizioni aggiornate. 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. Devi impostare il tipo di transizione di stato da applicare. Devi impostarne esattamente uno. 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 di 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 (ID) principale del piano base da disattivare.
basePlanId

string

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

enum (ProductUpdateLatencyTolerance)

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