Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Aggiorna un batch di stati di offerte di prodotti a pagamento singolo.

Richiesta HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/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 prodotti una tantum aggiornate.
productId

string

Obbligatorio. L'ID prodotto del prodotto a pagamento singolo principale, se tutte le offerte aggiornate appartengono allo stesso prodotto a pagamento singolo. Se questo aggiornamento batch riguarda più prodotti una tantum, imposta questo campo su "-".
purchaseOptionId

string

Obbligatorio. L'ID opzione di acquisto dell'opzione di acquisto principale, se tutte le offerte aggiornate appartengono alla stessa opzione di acquisto. Se questo aggiornamento batch riguarda più opzioni di acquisto, imposta questo campo su "-".

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

object (UpdateOneTimeProductOfferStateRequest)

Obbligatorio. L'elenco delle richieste di aggiornamento di 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 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Campi
oneTimeProductOffers[]

object (OneTimeProductOffer)

L'elenco aggiornato delle offerte di prodotti a pagamento singolo, nello stesso ordine della richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

UpdateOneTimeProductOfferStateRequest

Messaggio di richiesta per aggiornare lo stato di un'offerta di prodotto a pagamento singolo.

Rappresentazione JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // 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:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Attiva un'offerta. Una volta attivata, l'offerta è disponibile per gli utenti, a condizione che vengano soddisfatte le condizioni.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Annulla un'offerta. Una volta annullata, l'offerta non è più disponibile per gli utenti. Tutti gli ordini in attesa relativi a questa offerta verranno annullati. Questa transizione di stato è specifica per i preordini.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Disattiva un'offerta. Una volta disattivata, l'offerta non è più disponibile per gli utenti. Questa transizione di stato è specifica per le offerte scontate.

CancelOneTimeProductOfferRequest

Richiesta di messaggi per offers.cancel.

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

string

Obbligatorio. L'app genitore (nome del pacchetto) dell'offerta da annullare.
productId

string

Obbligatorio. L'ID del prodotto a pagamento singolo principale dell'offerta da annullare.
purchaseOptionId

string

Obbligatorio. L'opzione di acquisto principale (ID) dell'offerta da annullare.
offerId

string

Obbligatorio. L'ID offerta dell'offerta da annullare.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

Richiesta di messaggio per offers.deactivate.

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

string

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

string

Obbligatorio. L'ID del prodotto a pagamento singolo principale dell'offerta da disattivare.
purchaseOptionId

string

Obbligatorio. L'opzione di acquisto principale (ID) dell'offerta da disattivare.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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