Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aggiorna un gruppo di stati delle offerte di abbonamento.

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/{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 riguarda più sottoscrizioni, imposta questo campo su "-". Deve essere impostato.

basePlanId

string

Obbligatorio. Il piano base (ID) padre per il quale 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 con un massimo di 100 elementi. Tutte le richieste devono aggiornare offerte diverse.

Corpo della risposta

Messaggio di risposta per offer.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. Devi impostare il tipo di transizione di stato da applicare. Devi impostarne esattamente uno. 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 perActivateSubscriptionOffer.

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 (ID) principale dell'offerta da attivare.

basePlanId

string

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

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Messaggio di richiesta per offer.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 (ID) principale dell'offerta da disattivare.

basePlanId

string

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

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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