Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aggiorna un gruppo di stati delle offerte di abbonamento.

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/{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 su tutte le risorse SubscriptionOffer aggiornate.
productId

string

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

string

Obbligatorio. Il piano base (ID) principale di 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 contenente un massimo di 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 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:
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 quelli esistenti manterranno l'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 (ID) principale dell'offerta da attivare.
offerId

string

Obbligatorio. L'ID univoco dell'offerta 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.

DeactivateSubscriptionOfferRequest

Messaggio di richiesta 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 (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)

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