Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aktualisiert einen Satz von Aboangebotsstatus.

Setzen Sie das Feld „latenzTolerance“ bei verschachtelten Anfragen auf „PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT“, um einen maximalen Aktualisierungsdurchsatz zu erzielen.

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 bei allen aktualisierten SubscriptionOffer-Ressourcen dem Feld „packageName“ 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. 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 Aktualisierungsanfrageliste mit bis zu 100 Elementen. Bei jeder Anfrage müssen unterschiedliche 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 Abo-Angebote.

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. Die Art des anzuwendenden Statusübergangs. 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 steht das Angebot neuen Abonnenten zur Verfügung.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Deaktiviert ein Angebot. Nach der Deaktivierung ist das Angebot für neue Abonnenten nicht mehr verfügbar. Bestehende Abonnenten behalten jedoch 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 Angebots, das aktiviert werden soll.
productId

string

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

string

Erforderlich. Das übergeordnete Basis-Abo (ID) des zu aktivierenden Angebots.
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 zu deaktivierenden Angebots
productId

string

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

string

Erforderlich. Das übergeordnete Basis-Abo (die ID) des zu deaktivierenden Angebots.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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