Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aktualisiert den Status mehrerer Aboangebote.

Legen Sie das Feld „latencyTolerance“ in verschachtelten Anfragen auf „PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT“ fest, um den maximalen Aktualisierungsdurchsatz 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 mit dem Feld „packageName“ in allen aktualisierten SubscriptionOffer-Ressourcen übereinstimmen.
productId

string

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

string

Erforderlich. Das übergeordnete Basis-Abo (ID), für das 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. Alle Anfragen müssen unterschiedliche Angebote aktualisieren.

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

Anfrage 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 anzuwendende Statusübergang. Es muss genau einer 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.

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 zu aktivierenden Angebots.
productId

string

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

string

Erforderlich. Das übergeordnete Basis-Abo (ID) des Angebots, das aktiviert werden soll.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weiterleitung 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, das deaktiviert werden soll.
productId

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

Optional. Die Latenztoleranz für die Weiterleitung dieses Produktupdates. Die Standardeinstellung ist „Latenzempfindlich“.