Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Aktualisiert eine Gruppe von Angebotsstatus für Einmalkaufprodukte.

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 Einmalkaufprodukt-Angebote.

productId

string

Erforderlich. Die Produkt-ID des übergeordneten Einmalkaufprodukts, wenn alle aktualisierten Angebote zum selben Einmalkaufprodukt gehören. Wenn dieses Batch-Update mehrere Einmalkaufprodukte umfasst, legen Sie dieses Feld auf „-“ fest.

purchaseOptionId

string

Erforderlich. Die ID der übergeordneten Kaufoption, wenn alle aktualisierten Angebote zur selben Kaufoption gehören. Wenn dieses Batch-Update mehrere Kaufoptionen umfasst, 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 Einmalkaufprodukte 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 Einmalkaufprodukts.

JSON-Darstellung
{

  // 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.
}
Felder
Der Typ des anzuwendenden Zustandsübergangs. Es muss genau einer festgelegt werden. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
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 dem Widerruf ist das Angebot für Nutzer nicht mehr verfügbar. Alle ausstehenden Bestellungen im Zusammenhang mit diesem Angebot werden storniert. Diese Statusänderung gilt nur für Vorbestellungen.

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Deaktiviert ein Angebot. Nach der Deaktivierung ist das Angebot für Nutzer nicht mehr verfügbar. Diese Statusänderung gilt nur für Angebote mit Rabatten und Spielprämien.

Ende der sich gegenseitig ausschließenden Felder.

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 zu kündigenden Angebots.

offerId

string

Erforderlich. Die Angebots-ID des zu stornierenden Angebots.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weitergabe dieses Updates. Die Standardeinstellung ist „latenzempfindlich“.

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 Angebots, das deaktiviert werden soll.

productId

string

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

purchaseOptionId

string

Erforderlich. Die übergeordnete Kaufoption (ID) des zu deaktivierenden Angebots.

offerId

string

Erforderlich. Die Angebots-ID des Angebots, das deaktiviert werden soll.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weitergabe dieses Updates. Die Standardeinstellung ist „latenzempfindlich“.