Method: monetization.subscriptions.basePlans.batchUpdateStates

Consente di attivare o disattivare i piani base per uno o più abbonamenti.

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

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 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 contenente 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 degli abbonamenti aggiornati. Questo elenco abbinerà le 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 di un 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 di unione state_transition_type. Il tipo di transizione di stato da applicare. È necessario impostarne solo uno. state_transition_type può essere solo uno dei seguenti:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Attiva un piano base. Dopo l'attivazione, 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 quelli esistenti manterranno l'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 (ID) principale del piano base da attivare.
basePlanId

string

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

enum (ProductUpdateLatencyTolerance)

Campo facoltativo. La tolleranza di latenza per la propagazione dell'aggiornamento di questo 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 piano base univoco del piano base da disattivare.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Campo facoltativo. La tolleranza di latenza per la propagazione dell'aggiornamento di questo prodotto. Il valore predefinito è sensibile alla latenza.