Method: monetization.subscriptions.basePlans.batchUpdateStates

Hiermit können Sie Basis-Abos für ein oder mehrere Abos aktivieren oder deaktivieren.

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Die übergeordnete App (Paketname) der aktualisierten Basispläne.
productId

string

Erforderlich. Die Produkt-ID des übergeordneten Abos, wenn alle aktualisierten Basis-Abos zum selben Abo gehören. Wenn diese Bulk-Aktualisierung mehrere Abos umfasst, setzen Sie dieses Feld auf „-“.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (UpdateBasePlanStateRequest)

Erforderlich. Die Liste der Aktualisierungsanfragen mit bis zu 100 Elementen. Alle Anfragen müssen unterschiedliche Basispläne aktualisieren.

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 entspricht den Anfragen genau und in derselben Reihenfolge.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

UpdateBasePlanStateRequest

Anfrage 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. Der anzuwendende Statusübergang. 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 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 ID des zu aktivierenden Basis-Abos.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

enum (ProductUpdateLatencyTolerance)

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