Von Version 5 oder 6 zu Google Play Billing Library 7 migrieren

In diesem Dokument wird die Migration von Google Play Billing Library 5 oder 6 beschrieben. zu Google Play Billing Library 7 und wie die Integration mit dem neuen optionalen Abo-Funktionen nutzen können.

Eine vollständige Liste der Änderungen in Version 7.0.0 finden Sie im Release Notizen.

Übersicht

Google Play Billing Library 7 verbessert die Zahlungsabwicklung für bestehende Abo-Funktionen nutzen können. Diese optionalen Verbesserungen Unterstützung für Raten- und Ratenzahlungen Unterstützung ausstehender Käufe für Prepaid-Abonnements.

Abwärtskompatibles Upgrade der Play Billing Library

Alle neuen APIs der Google Play Billing Library 7 sind optional. Entwickler müssen für die Aktualisierung keine API-Änderungen implementieren.

Für die Migration müssen Sie API-Referenzen aktualisieren und entfernen APIs aus Ihrer App, wie in den Versionshinweisen und weiter unten beschrieben Migrationsanleitung.

Upgrade von PBL 5 auf PBL 7

In den folgenden Abschnitten wird das Upgrade von PBL 5 auf PBL 7 beschrieben.

Google Play Billing Library aktualisieren

Aktualisiere die Play Billing Library-Abhängigkeitsversion in die Datei build.gradle Ihrer App.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Aktualisieren Sie als Nächstes Ihre API-Referenzen wie in den folgenden Abschnitten beschrieben.

Abokäufe eines Nutzers ändern

Play Billing Library 5 und frühere Versionen verwendet ProrationMode um Änderungen auf die Abokäufe eines Nutzers anzuwenden, z. B. Upgrades oder Downgrades. Diese API wurde entfernt und ersetzt durch ReplacementMode

Umgang mit Änderungen der Abopreise

Die zuvor verworfene launchPriceConfirmationFlow API wurde entfernt. Alternativen findest du in den Preisänderungen .

Abobezogene API-Änderungen verarbeiten

Die zuvor verworfenen APIs setOldSkuPurchaseToken, setReplaceProrationMode und setReplaceSkusProrationMode wurden entfernt.

Fehler bei der Play Billing Library beheben

Ein neuer NETWORK_ERROR-Code weist auf Probleme mit der Netzwerkverbindung hin. zwischen dem Gerät des Nutzers und dem Google Play-System.

Die Codes SERVICE_TIMEOUT und SERVICE_UNAVAILABLE wurden ebenfalls aktualisiert.

Weitere Informationen finden Sie unter BillingResult-Antwortcodes verarbeiten.

Ausstehende Transaktionen verarbeiten

In der Play Billing Library wird für ausstehende Käufe keine Bestell-ID mehr erstellt. Bei diesen Käufen wird die Bestell-ID ausgefüllt, nachdem der Kauf verschoben wurde in den Status PURCHASED geändert. Achten Sie darauf, dass Ihre Integration erst nach vollständigem Abschluss einer Transaktion eine Auftrags-ID. Sie können weiterhin das Kauftoken für Ihre Unterlagen.

Weitere Informationen zum Umgang mit ausstehenden Käufen findest du in der Integrationsleitfaden für Play Billing Library und Leitfaden zur Verwaltung des Kauflebenszyklus.

Entfernte APIs zur alternativen Abrechnung verarbeiten

BillingClient.Builder.enableAlternativeBilling entfernt, AlternativeBillingListener, und AlternativeChoiceDetails. Entwickler sollten BillingClient.Builder.enableUserChoiceBilling() mit UserChoiceBillingListener verwenden und UserChoiceDetails im Listener-Callback.

Mit diesem Update werden die eingestellten APIs umbenannt, das Verhalten bleibt unverändert.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

Ausstehende Käufe für Prepaid-Tarife unterstützen

Weitere Informationen findest du im Leitfaden Umgang mit Abos und ausstehenden Transaktionen.

Virtuelle Ratenabos

Weitere Informationen finden Sie im Leitfaden zur Integration von Ratenabos.

Upgrade von PBL 6 auf PBL 7

In den folgenden Abschnitten wird das Upgrade von PBL 6 auf PBL 7 beschrieben.

Google Play Billing Library aktualisieren

Aktualisiere die Play Billing Library-Abhängigkeitsversion in die Datei build.gradle Ihrer App.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Aktualisieren Sie als Nächstes Ihre API-Referenzen wie in den folgenden Abschnitten beschrieben.

Abobezogene API-Änderungen verarbeiten

Die zuvor verworfenen APIs setOldSkuPurchaseToken, setReplaceProrationMode und setReplaceSkusProrationMode wurden entfernt.

Entfernte APIs zur alternativen Abrechnung verarbeiten

BillingClient.Builder.enableAlternativeBilling entfernt, AlternativeBillingListener und AlternativeChoiceDetails. Entwickler sollten BillingClient.Builder.enableUserChoiceBilling() mit UserChoiceBillingListener verwenden und UserChoiceDetails im Listener-Callback.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

Ausstehende Käufe für Prepaid-Tarife unterstützen

Weitere Informationen findest du im Leitfaden Umgang mit Abos und ausstehenden Transaktionen.

Virtuelle Ratenabos

Weitere Informationen finden Sie im Leitfaden Integration von Ratenabos für Informationen zur Integration dieser Änderungen in Ihre App.