Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Aktualisiert den Status einer Reihe von Einmalkaufproduktangeboten.

HTTP-Anfrage

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Die übergeordnete App (Paketname) der aktualisierten Einmalkauf-Angebote.
productId

string

Erforderlich. Die Produkt-ID des übergeordneten Einmalkaufprodukts, wenn alle aktualisierten Angebote zum selben Einmalkaufprodukt gehören. Wenn sich diese Batch-Aktualisierung auf mehrere Einmalkäufe bezieht, setzen Sie dieses Feld auf „-“.
purchaseOptionId

string

Erforderlich. Die Kaufoptions-ID der übergeordneten Kaufoption, wenn alle aktualisierten Angebote zur selben Kaufoption gehören. Wenn sich diese Batch-Aktualisierung auf mehrere Kaufoptionen bezieht, legen Sie dieses Feld auf „-“ fest.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferStateRequest)
    }
  ]
}
Felder
requests[]

object (UpdateOneTimeProductOfferStateRequest)

Erforderlich. Die Liste der Aktualisierungsanfragen mit bis zu 100 Elementen. Alle Anfragen müssen sich auf unterschiedliche Angebote beziehen.

Antworttext

Antwortnachricht für offers.batchUpdateStates.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Felder
oneTimeProductOffers[]

object (OneTimeProductOffer)

Die aktualisierte Liste der Einmalkaufproduktangebote in derselben Reihenfolge wie in der Anfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

UpdateOneTimeProductOfferStateRequest

Anfragenachricht zum Aktualisieren des Status eines einmaligen Produktangebots.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld state_transition_type. Der Typ des anzuwendenden Statusübergangs. Es muss genau einer festgelegt werden. Für state_transition_type ist nur einer der folgenden Werte zulässig:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Aktiviert ein Angebot. Nach der Aktivierung ist das Angebot für Nutzer verfügbar, solange die Bedingungen erfüllt sind.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Storniert ein Angebot. Nach der Kündigung ist das Angebot für Nutzer nicht mehr verfügbar. Alle ausstehenden Bestellungen im Zusammenhang mit diesem Angebot werden storniert. Dieser Statusübergang gilt nur für Vorbestellungen.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Deaktiviert ein Angebot. Nach der Deaktivierung ist das Angebot für Nutzer nicht mehr verfügbar. Dieser Statusübergang gilt nur für Angebote mit Rabatt.

CancelOneTimeProductOfferRequest

Anfragenachricht für offers.cancel

JSON-Darstellung 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Felder
packageName

string

Erforderlich. Die übergeordnete App (Paketname) des Angebots, das gekündigt werden soll.
productId

string

Erforderlich. Das übergeordnete Einmalkaufprodukt (ID) des zu kündigenden Angebots.
purchaseOptionId

string

Erforderlich. Die übergeordnete Kaufoption (ID) des Angebots, das gekündigt werden soll.
offerId

string

Erforderlich. Die Angebots-ID des zu kündigenden Angebots.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weitergabe dieses Updates. Die Standardeinstellung ist „latency-sensitive“.

DeactivateOneTimeProductOfferRequest

Anfragenachricht für „offers.deactivate“

JSON-Darstellung 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Felder
packageName

string

Erforderlich. Die übergeordnete App (Paketname) des zu deaktivierenden Angebots.
productId

string

Erforderlich. Das übergeordnete Einmalkaufprodukt (ID) des zu deaktivierenden Angebots.
purchaseOptionId

string

Erforderlich. Die übergeordnete Kaufoption (ID) des Angebots, das deaktiviert werden soll.
offerId

string

Erforderlich. Die Angebots-ID des zu deaktivierenden Angebots.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weitergabe dieses Updates. Die Standardeinstellung ist „latency-sensitive“.