- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- DefiniteTransition
- TentativeTransition
- Testen!
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 |
Erforderlich. Das Paket der App, für die dieses Abo gekauft wurde (z. B. „com.some.thing“). |
token |
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 ( |
| Felder | |
|---|---|
productId |
Erforderlich. Das Aboprodukt (z. B. „premium_plan“), für das die Umstellung geplant werden muss. |
earliestTransitionEffectiveTime |
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: |
| [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 |
In diesem Modus ist der Wechsel des Nutzers zum neuen Abo endgültig und kann nicht abgebrochen werden. |
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 |
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 ( |
| Felder | |
|---|---|
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.