Method: purchases.subscriptionsv2.scheduleplantransition

Wechsel des Abos planen

HTTP-Anfrage

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Das Paket der App, für die dieses Abo gekauft wurde (z. B. „com.some.thing“).

token

string

Erforderlich. Das Token, das dem Gerät des Nutzers beim Kauf des Abos bereitgestellt wurde.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Felder
productId

string

Erforderlich. Das Aboprodukt (z. B. „premium_plan“), für das die Umstellung geplant werden muss.

earliestTransitionEffectiveTime

string (Timestamp format)

Erforderlich. Der früheste Zeitpunkt, zu dem die Tarifumstellung wirksam werden kann. Die tatsächliche Umstellung erfolgt zum Zeitpunkt der Verlängerung am oder nach diesem Datum.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

[Erforderlich] Der Modus für die Tarifumstellung. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
definiteTransition

object (DefiniteTransition)

In diesem Modus ist der Wechsel des Nutzers zum neuen Abo endgültig und kann nicht abgebrochen werden.

tentativeTransition

object (TentativeTransition)

Wenn Sie diesen Modus nutzen, ist der Wechsel des Nutzers zum neuen Tarif vorläufig und kann abgebrochen werden.

Ende der sich gegenseitig ausschließenden Felder.
etag

string

Wenn festgelegt, schlägt die API fehl, wenn das ETag nicht mit dem neuesten ETag für dieses Abo übereinstimmt. Das ETag wird über „purchases.subscriptionsv2.get“ abgerufen: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Antworttext

Antwort für die API „purchases.subscriptionsv2.schedulePlanTransition“.

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

JSON-Darstellung
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Felder
planTransitionDetails

object (PlanTransitionDetails)

Die Details zum Tarifwechsel des Aboartikels.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

DefiniteTransition

Dieser Typ hat keine Felder.

Wird verwendet, um anzugeben, dass die Tarifumstellung endgültig ist.

TentativeTransition

Dieser Typ hat keine Felder.

Wird verwendet, um anzugeben, dass die Planumstellung vorläufig ist.