Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aggiorna un batch di stati delle offerte di abbonamento.

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/{basePlanId}/offers:batchUpdateStates

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
packageName

string

Obbligatorio. L'app principale (nome del pacchetto) delle offerte di abbonamento aggiornate.

Deve essere uguale al campo packageName in tutte le risorse SubscriptionOffer aggiornate.
productId

string

Obbligatorio. L'ID prodotto dell'abbonamento principale, se tutte le offerte aggiornate appartengono allo stesso abbonamento. Se questa richiesta interessa più abbonamenti, imposta questo campo su "-". Deve essere impostato.
basePlanId

string

Obbligatorio. Il piano base principale (ID) per cui devono essere aggiornate le offerte. Può essere specificato come "-" per aggiornare le offerte di più piani base.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

object (UpdateSubscriptionOfferStateRequest)

Obbligatorio. L'elenco delle richieste di aggiornamento di massimo 100 elementi. Tutte le richieste devono aggiornare offerte diverse.

Corpo della risposta

Messaggio di risposta per offers.batchUpdateStates.

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

Rappresentazione JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Campi
subscriptionOffers[]

object (SubscriptionOffer)

L'elenco aggiornato delle offerte di abbonamento.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

UpdateSubscriptionOfferStateRequest

Messaggio di richiesta per aggiornare lo stato di un'offerta di abbonamento.

Rappresentazione JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // 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:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Attiva un'offerta. Una volta attivata, l'offerta sarà disponibile per i nuovi abbonati.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Disattiva un'offerta. Una volta disattivata, l'offerta non sarà più disponibile per i nuovi abbonati, ma gli abbonati esistenti manterranno il proprio abbonamento

ActivateSubscriptionOfferRequest

Messaggio di richiesta per ActivateSubscriptionOffer.

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

string

Obbligatorio. L'app principale (nome del pacchetto) dell'offerta da attivare.
productId

string

Obbligatorio. L'abbonamento principale (ID) dell'offerta da attivare.
basePlanId

string

Obbligatorio. Il piano base principale (ID) dell'offerta da attivare.
offerId

string

Obbligatorio. L'ID univoco dell'offerta da attivare.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Richiedi un messaggio per offers.deactivate.

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

string

Obbligatorio. L'app principale (nome del pacchetto) dell'offerta da disattivare.
productId

string

Obbligatorio. L'abbonamento principale (ID) dell'offerta da disattivare.
basePlanId

string

Obbligatorio. Il piano base principale (ID) dell'offerta da disattivare.
offerId

string

Obbligatorio. L'ID univoco dell'offerta da disattivare.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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