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

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

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

Übersicht

Google Play Billing Library 7 verbessert die Zahlungsabwicklung für bestehende Abofunktionen. Diese optionalen Verbesserungen ergänzen die Unterstützung für die Bezahlung mit Ratenzahlungen sowie die Unterstützung ausstehender Käufe bei Prepaid-Abos.

Abwärtskompatibles Play Billing Library-Upgrade

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

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

Upgrade von PBL 5 auf PBL 7

In den folgenden Abschnitten wird beschrieben, wie ein Upgrade von PBL 5 auf PBL 7 durchgeführt wird.

Google Play Billing Library aktualisieren

Aktualisieren Sie die Play Billing Library-Abhängigkeitsversion 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.

Abokäufe von Nutzern ändern

In 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.

Abopreisänderungen verarbeiten

Die zuvor verworfene launchPriceConfirmationFlow API wurde entfernt. Informationen zu Alternativen findest du im Leitfaden zu Preisänderungen.

Abobezogene API-Änderungen verarbeiten

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

Play Billing Library-Fehler beheben

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 findest du unter Umgang mit BillingResult-Antwortcodes.

Ausstehende Transaktionen verarbeiten

Die Play Billing Library erstellt keine Bestell-ID mehr für ausstehende Käufe. Bei diesen Käufen wird die Bestell-ID eingefügt, nachdem der Kauf in den Status PURCHASED verschoben wurde. Achten Sie darauf, dass in Ihrer Integration erst dann eine Bestell-ID erwartet wird, wenn eine Transaktion vollständig abgeschlossen ist. Sie können das Kauftoken weiterhin für Ihre Unterlagen verwenden.

Weitere Informationen zur Verarbeitung ausstehender Käufe findest du im Integrationsleitfaden für die Play Billing Library und im Leitfaden zur Verwaltung des Kauflebenszyklus.

Umgang mit entfernten APIs zur alternativen Abrechnung

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

Bei diesem Update werden die eingestellten APIs ohne Verhaltensänderungen umbenannt.

Optionale Änderungen

PBL 7 beinhaltet zwei neue optionale APIs.

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

Weitere Informationen findest du im Leitfaden Abos und ausstehende Transaktionen verarbeiten.

Virtuelle Ratenzahlungen

Weitere Informationen finden Sie im Leitfaden zur Integration von Ratenzahlungen.

Upgrade von PBL 6 auf PBL 7

In den folgenden Abschnitten wird beschrieben, wie ein Upgrade von PBL 6 auf PBL 7 durchgeführt wird.

Google Play Billing Library aktualisieren

Aktualisieren Sie die Play Billing Library-Abhängigkeitsversion 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.

Umgang mit entfernten APIs zur alternativen Abrechnung

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 beinhaltet zwei neue optionale APIs.

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

Weitere Informationen findest du im Leitfaden Abos und ausstehende Transaktionen verarbeiten.

Virtuelle Ratenzahlungen

In der Anleitung Integration von Ratenzahlungen findest du Informationen dazu, wie du diese Änderungen in deine App einbindest.