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 umfassen die Unterstützung für Zahlungen in Raten sowie für ausstehende Käufe für Prepaid-Abos.

Abwärtskompatibles Play Billing Library-Upgrade

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

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

Upgrade von PBL 5 auf PBL 7

In den folgenden Abschnitten wird beschrieben, wie Sie von PBL 5 auf PBL 7 umstellen.

Google Play Billing Library aktualisieren

Aktualisieren Sie die Abhängigkeitsversion der Play Billing Library 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 eines Nutzers ändern

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

Umgang mit Preisänderungen für Abos

Die zuvor eingestellte 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.

Play Billing Library-Fehler 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 SERVICE_TIMEOUT- und SERVICE_UNAVAILABLE-Codes wurden ebenfalls aktualisiert.

Weitere Informationen finden Sie unter BillingResult-Antwortcodes verarbeiten.

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 erst erfasst, wenn der Kauf in den Status PURCHASED verschoben wurde. Achten Sie darauf, dass Ihre Integration eine Bestell-ID erst erwartet, nachdem eine Transaktion vollständig abgeschlossen ist. Sie können das Kauftoken aber weiterhin für Ihre Daten 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 veralteten APIs umbenannt, ohne dass sich ihr Verhalten ä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 Abos und ausstehende Transaktionen verarbeiten.

Abos mit virtuellen Raten

Weitere Informationen finden Sie in der Anleitung zur Integration von Abos mit Ratenzahlung.

Upgrade von PBL 6 auf PBL 7

In den folgenden Abschnitten wird beschrieben, wie Sie von PBL 6 auf PBL 7 umstellen.

Google Play Billing Library aktualisieren

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

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

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

Abos mit virtuellen Raten

Im Leitfaden Abos mit Ratenzahlungen einbinden erfahren Sie, wie Sie diese Änderungen in Ihre App einbinden.