Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Aggiorna un gruppo di stati delle 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 di percorso

Parametri
packageName

string

Obbligatorio. L'app principale (nome del pacchetto) delle offerte di prodotti a pagamento singolo 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 a pagamento singolo, 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 contenente fino a 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
Campi
Il tipo di transizione di stato da applicare. Deve essere impostato esattamente un tipo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Attiva un'offerta. Una volta attivata, l'offerta è disponibile per gli utenti, a condizione che ne 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 pre-ordini.
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 e i premi dei giochi.
Fine dei campi che si escludono a vicenda.

CancelOneTimeProductOfferRequest

Messaggio di richiesta per offers.cancel.

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

string

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

string

Obbligatorio. Il prodotto a pagamento singolo principale (ID) dell'offerta da annullare.
purchaseOptionId

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

Messaggio di richiesta per offers.deactivate.

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

string

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

string

Obbligatorio. Il prodotto a pagamento singolo principale (ID) 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 di latenza per la propagazione di questo aggiornamento. Il valore predefinito è sensibile alla latenza.