Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aktualisiert einen Batch von Aboangebotsstatus.

Legen Sie für das Feld "LatenzTolerance" bei verschachtelten Anfragen den Wert "PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" fest, um einen maximalen Updatedurchsatz zu erreichen.

HTTP-Anfrage

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Die übergeordnete App (Paketname) der aktualisierten Aboangebote.

Muss dem Feld „packageName“ in allen aktualisierten SubscriptionOffer-Ressourcen entsprechen.
productId

string

Erforderlich. Die Produkt-ID des übergeordneten Abos, wenn alle aktualisierten Angebote zum selben Abo gehören. Wenn diese Anfrage mehrere Abos umfasst, setzen Sie dieses Feld auf „-“. Muss festgelegt werden.
basePlanId

string

Erforderlich. Die ID des übergeordneten Basis-Abos, für die die Angebote aktualisiert werden sollen. Kann als "-" angegeben werden , um Angebote aus mehreren Basis-Abos zu aktualisieren.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (UpdateSubscriptionOfferStateRequest)

Erforderlich. Die Liste der Aktualisierungsanfragen mit bis zu 100 Elementen. Bei allen Anfragen müssen verschiedene Angebote aktualisiert werden.

Antworttext

Antwortnachricht für Offers.batchUpdateStates.

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

JSON-Darstellung 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Felder
subscriptionOffers[]

object (SubscriptionOffer)

Die aktualisierte Liste der Aboangebote.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

UpdateSubscriptionOfferStateRequest

Anfragenachricht zum Aktualisieren des Status eines Aboangebots.

JSON-Darstellung 
{

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

object (ActivateSubscriptionOfferRequest)

Aktiviert ein Angebot. Nach der Aktivierung ist das Angebot für neue Abonnenten verfügbar.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Deaktiviert ein Angebot. Nach der Deaktivierung ist das Angebot für neue Abonnenten nicht mehr verfügbar. Bestehende Abonnenten behalten ihr Abo jedoch weiterhin.

ActivateSubscriptionOfferRequest

Anfragenachricht für ActivateSubscriptionOffer.

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

string

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

string

Erforderlich. Das übergeordnete Abo (ID) des zu aktivierenden Angebots.
basePlanId

string

Erforderlich. Die ID des übergeordneten Basis-Abos, das aktiviert werden soll.
offerId

string

Erforderlich. Die eindeutige Angebots-ID des zu aktivierenden Angebots.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weitergabe dieses Produktupdates. Die Standardeinstellung ist latenzempfindlich.

DeactivateSubscriptionOfferRequest

Anfragenachricht für Offers.deactivate.

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

string

Erforderlich. Die übergeordnete App (Paketname) des Angebots zur Deaktivierung.
productId

string

Erforderlich. Das übergeordnete Abo (ID) des Angebots, das deaktiviert werden soll.
basePlanId

string

Erforderlich. Die ID des übergeordneten Basis-Abos für das zu deaktivierende Angebot.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weitergabe dieses Produktupdates. Die Standardeinstellung ist latenzempfindlich.