Method: monetization.subscriptions.basePlans.batchUpdateStates

Aktiviert oder deaktiviert Basis-Abos für ein oder mehrere Abos.

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:batchUpdateStates

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Die übergeordnete App (Paketname) des aktualisierten Basis-Abos.

productId

string

Erforderlich. Die Produkt-ID des übergeordneten Abos, wenn alle aktualisierten Basis-Abos zum selben Abo gehören. Wenn diese Batch-Aktualisierung mehrere Abos umfasst, setzen Sie dieses Feld auf "-". Muss festgelegt werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (UpdateBasePlanStateRequest)

Erforderlich. Die Aktualisierungsanfrageliste mit bis zu 100 Elementen. Für alle Anfragen müssen unterschiedliche Basis-Abos aktualisiert werden.

Antworttext

Antwortnachricht für basePlans.batchUpdateStates.

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

JSON-Darstellung
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Felder
subscriptions[]

object (Subscription)

Die Liste der aktualisierten Abos. Diese Liste gleicht die Anfragen eins zu eins in derselben Reihenfolge ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

UpdateBasePlanStateRequest

Anfragenachricht zum Aktualisieren des Status eines Basis-Abos.

JSON-Darstellung
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // 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:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Aktiviert ein Basis-Abo. Nach der Aktivierung sind Basis-Abos für neue Abonnenten verfügbar.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Deaktiviert ein Basis-Abo. Nach der Deaktivierung ist das Basis-Abo für neue Abonnenten nicht mehr verfügbar. Bestehende Abonnenten behalten aber ihr Abo.

ActivateBasePlanRequest

Anfragenachricht für ActivateBasePlan.

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

string

Erforderlich. Die übergeordnete App (Paketname) des zu aktivierenden Basis-Abos.

productId

string

Erforderlich. Das übergeordnete Abo (ID) des zu aktivierenden Basis-Abos.

basePlanId

string

Erforderlich. Die eindeutige Basis-Abo-ID des zu aktivierenden Basis-Abos.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

Anfragenachricht für basePlans.deactivate.

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

string

Erforderlich. Die übergeordnete App (Paketname) des zu deaktivierenden Basis-Abos.

productId

string

Erforderlich. Das übergeordnete Abo (ID) des zu deaktivierenden Basis-Abos.

basePlanId

string

Erforderlich. Die eindeutige ID des zu deaktivierenden Basis-Abos.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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