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 wie Sie 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 Bezahlung mit Ratenzahlungsplänen 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 und Entwickler müssen keine API-Änderungen implementieren, um die Aktualisierung vorzunehmen.

Für die Migration müssen Sie API-Referenzen 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üheren Versionen 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.

Änderungen von Abopreisen verwalten

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

Abo-bezogene API-Änderungen verarbeiten

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

Fehler in der Play Billing Library 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 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 ausgefüllt, nachdem der Kauf in den Status PURCHASED verschoben wurde. Achte darauf, dass deine Integration eine Bestell-ID erst erwartet, wenn eine Transaktion vollständig abgeschlossen ist. Sie können das Kaufftoken weiterhin für Ihre Unterlagen verwenden.

Weitere Informationen zum Umgang mit ausstehenden Käufen findest du 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. Verwenden Sie stattdessen BillingClient.Builder.enableUserChoiceBilling() mit UserChoiceBillingListener und UserChoiceDetails im Listener-Callback.

Bei diesem Update werden die verworfenen APIs umbenannt, ohne dass sich das Verhalten ändert.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

Unterstützung für ausstehende Käufe von Prepaid-Tarifen

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

Abos mit virtuellen Raten

Weitere Informationen finden Sie im Leitfaden Integration von Ratenabos.

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.

Abo-bezogene 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. Verwenden Sie stattdessen BillingClient.Builder.enableUserChoiceBilling() mit UserChoiceBillingListener und UserChoiceDetails im Listener-Callback.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

Unterstützung für ausstehende Käufe von Prepaid-Tarifen

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

Abos mit virtuellen Raten

Informationen zum Einbinden dieser Änderungen in deine App findest du im Leitfaden zur Einbindung von Ratenabos.