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 Abo-Funktionen einbinden.

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

Übersicht

Mit der Google Play Billing Library 7 wird die Zahlungsabwicklung für bestehende Abo-Funktionen verbessert. Durch diese optionalen Verbesserungen wird die Zahlung mit Ratenzahlungsplänen sowie die Unterstützung für ausstehende Käufe für Prepaid-Abos hinzugefügt.

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 weiter unten in diesem Migrationsleitfaden beschrieben.

Upgrade von PBL 5 auf PBL 7

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

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-Verweise, 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 Abo-Käufen eines Nutzers vorzunehmen, z. B. Upgrades oder Downgrades. Diese API wurde entfernt und durch ReplacementMode ersetzt.

Änderungen des Abopreises verarbeiten

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

API-Änderungen im Zusammenhang mit Abos verarbeiten

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

Fehler der Play Billing Library verarbeiten

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 Antwortcodes von BillingResult 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 PURCHASED Status verschoben wurde. Achten Sie darauf, dass Ihre Integration eine Bestell-ID erst erwartet, nachdem eine Transaktion vollständig abgeschlossen wurde. Sie können das Kauf-Token weiterhin für Ihre Aufzeichnungen verwenden.

Weitere Informationen zum Verarbeiten ausstehender Käufe 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 diesem Update werden die verworfenen APIs nur umbenannt. Es gibt keine Verhaltensänderungen.

Optionale Änderungen

PBL 7 enthält zwei neue optionale APIs.

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

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

Abos mit virtueller Ratenzahlung

Weitere Informationen finden Sie im Integrationsleitfaden für Abos mit Ratenzahlung.

Upgrade von PBL 6 auf PBL 7

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

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-Verweise, wie in den folgenden Abschnitten beschrieben.

API-Änderungen im Zusammenhang mit Abos 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 für ausstehende Käufe für Prepaid-Tarife

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

Abos mit virtueller Ratenzahlung

Informationen zum Einbinden dieser Änderungen in Ihre App finden Sie im Integrationsleitfaden für Abos mit Ratenzahlung.