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

In diesem Dokument wird beschrieben, wie Sie von der Google Play Billing Library 5 oder 6 zur Google Play Billing Library 7 migrieren und die neuen optionalen Abofunktionen einbinden.

Eine vollständige Liste der Änderungen in Version 7.0.0 finden Sie in den Versionshinweisen.

Übersicht

Die Google Play Billing Library 7 verbessert die Zahlungsabwicklung für bestehende Abofunktionen. Diese optionalen Verbesserungen bieten Unterstützung für die Zahlung mit Raten sowie für ausstehende Käufe für Prepaid-Abos.

Abwärtskompatibles Upgrade der Play Billing Library

Alle neuen APIs der Google Play Billing Library 7 sind optional. Entwickler müssen keine API-Änderungen implementieren, um ein Update durchzuführen.

Für die Migration müssen Sie API-Verweise aktualisieren und bestimmte APIs aus Ihrer App entfernen, wie in den Versionshinweisen und später in dieser Migrationsanleitung beschrieben.

Upgrade von PBL 5 auf PBL 7

In den folgenden Abschnitten wird beschrieben, wie Sie ein Upgrade von PBL 5 auf PBL 7 durchführen.

Google Play Billing Library aktualisieren

Aktualisieren Sie die Version der Play Billing Library-Abhängigkeit in der 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.

Abo-Käufe eines Nutzers ändern

In der Play Billing Library 5 und früher wurde ProrationMode verwendet, um Änderungen an den Abokäufen eines Nutzers vorzunehmen, z. B. Upgrades oder Downgrades. Diese API wurde entfernt und durch ReplacementMode ersetzt.

Umgang mit Preisänderungen bei Abos

Die zuvor verworfene launchPriceConfirmationFlow API wurde entfernt. Alternativen finden Sie im Leitfaden zu Preisänderungen.

Abobezogene API-Änderungen verarbeiten

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

Fehler in der Play Billing Library behandeln

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

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 keine Bestell-ID mehr für ausstehende Käufe erstellt. Bei diesen Käufen wird die Bestell-ID erst ausgefüllt, wenn der Kauf in den Status PURCHASED verschoben wird. Achten Sie darauf, dass in Ihrer Integration eine Bestell-ID erst erwartet wird, nachdem eine Transaktion vollständig abgeschlossen wurde. Sie können das Kauf-Token weiterhin für Ihre Unterlagen verwenden.

Weitere Informationen zum Umgang mit ausstehenden Käufen finden Sie im Integrationsleitfaden für die Play Billing Library und im Leitfaden zur Verwaltung des Kauflebenszyklus.

Entfernte APIs zur alternativen Abrechnung verarbeiten

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

Bei dieser Aktualisierung werden die eingestellten APIs umbenannt. Das Verhalten ändert sich nicht.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

Unterstützung ausstehender Käufe für Prepaid-Tarife

Weitere Informationen finden Sie im Leitfaden Abos und ausstehende Transaktionen verwalten.

Abos mit virtuellen Raten

Weitere Informationen finden Sie im Leitfaden Integration von Abos mit Ratenzahlung.

Upgrade von PBL 6 auf PBL 7

In den folgenden Abschnitten wird beschrieben, wie Sie ein Upgrade von PBL 6 auf PBL 7 durchführen.

Google Play Billing Library aktualisieren

Aktualisieren Sie die Version der Play Billing Library-Abhängigkeit in der 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, AlternativeBillingListener und AlternativeChoiceDetails wurden entfernt. Entwickler sollten stattdessen BillingClient.Builder.enableUserChoiceBilling() mit UserChoiceBillingListener und UserChoiceDetails im Listener-Callback verwenden.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

Unterstützung ausstehender Käufe für Prepaid-Tarife

Weitere Informationen finden Sie im Leitfaden Abos und ausstehende Transaktionen verwalten.

Abos mit virtuellen Raten

Informationen dazu, wie du diese Änderungen in deine App einbindest, findest du im Leitfaden Integration von Abos mit Ratenzahlung.