Przechodzenie z wersji 5 lub 6 do Biblioteki płatności w Google Play 7

Z tego dokumentu dowiesz się, jak przejść z Biblioteki płatności w Google Play w wersji 5 lub 6 na Bibliotekę płatności w Google Play w wersji 7 oraz jak zintegrować ją z nowymi opcjonalnymi funkcjami subskrypcji.

Pełną listę zmian w wersji 7.0.0 znajdziesz w informacjach o wersji.

Przegląd

Biblioteka płatności w Google Play w wersji 7 usprawnia obsługę płatności w przypadku dotychczasowych funkcji subskrypcji. Te opcjonalne ulepszenia dodają obsługę płatności w ratach oraz obsługę oczekujących zakupów w przypadku subskrypcji przedpłaconych.

Uaktualnienie Biblioteki płatności w Play zgodne wstecz

Wszystkie nowe interfejsy API Biblioteki płatności w Google Play w wersji 7 są opcjonalne, a deweloperzy nie muszą wprowadzać żadnych zmian w interfejsie API, aby przeprowadzić aktualizację.

Aby przeprowadzić migrację, musisz zaktualizować odwołania do interfejsu API i usunąć z aplikacji niektóre interfejsy API zgodnie z opisem w informacjach o wersji i w dalszej części tego przewodnika.

Przechodzenie z Biblioteki płatności w Play w wersji 5 na Bibliotekę płatności w Play w wersji 7

W sekcjach poniżej znajdziesz opis przejścia z Biblioteki płatności w Play w wersji 5 na Bibliotekę płatności w Play w wersji 7.

Aktualizacja Biblioteki płatności w Google Play

Zaktualizuj wersję zależności Biblioteki płatności w Play w pliku build.gradle aplikacji.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Następnie zaktualizuj odwołania do interfejsu API zgodnie z opisem w sekcjach poniżej.

Zmiana zakupów subskrypcji użytkownika

Biblioteka płatności w Play w wersji 5 i starszych używała ProrationMode do wprowadzania zmian w zakupach subskrypcji użytkownika, takich jak przejście na wyższy lub niższy poziom. Ten interfejs API został usunięty i zastąpiony przez ReplacementMode.

Obsługa zmian cen subskrypcji

Wycofany wcześniej interfejs API launchPriceConfirmationFlow został usunięty. Alternatywne rozwiązania znajdziesz w przewodniku po zmianach cen.

Obsługa zmian w interfejsie API związanych z subskrypcjami

Wycofane wcześniej interfejsy API setOldSkuPurchaseToken, setReplaceProrationMode i setReplaceSkusProrationMode zostały usunięte.

Obsługa błędów Biblioteki płatności w Play

Nowy kod NETWORK_ERROR wskazuje na problemy z połączeniem sieciowym między urządzeniem użytkownika a systemem Google Play.

Zaktualizowano też kody SERVICE_TIMEOUT i SERVICE_UNAVAILABLE.

Więcej informacji znajdziesz w artykule Obsługa kodów odpowiedzi BillingResult.

Obsługa oczekujących transakcji

Biblioteka płatności w Play nie tworzy już identyfikatora zamówienia w przypadku oczekujących zakupów. W przypadku tych zakupów identyfikator zamówienia jest wypełniany po przeniesieniu zakupu do stanu PURCHASED. Upewnij się, że integracja oczekuje identyfikatora zamówienia dopiero po całkowitym zakończeniu transakcji. Nadal możesz używać tokena zakupu w swoich rekordach.

Więcej informacji o obsłudze oczekujących zakupów znajdziesz w przewodniku po integracji z Biblioteką płatności w Play oraz w przewodniku po zarządzaniu cyklem życia zakupu.

Obsługa usuniętych interfejsów API do rozliczeń alternatywnych

Usunięto BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, i AlternativeChoiceDetails. Deweloperzy powinni zamiast tego używać BillingClient.Builder.enableUserChoiceBilling() z UserChoiceBillingListener i UserChoiceDetails w wywołaniu zwrotnym detektora.

Ta aktualizacja polega na zmianie nazwy wycofanych interfejsów API bez zmiany ich działania.

Opcjonalne zmiany

Biblioteka płatności w Play w wersji 7 zawiera 2 nowe opcjonalne interfejsy API.

Obsługa oczekujących zakupów w przypadku abonamentów przedpłaconych

Zapoznaj się z przewodnikiem Obsługa subskrypcji i oczekujących transakcji.

Subskrypcje z wirtualnymi ratami

Zapoznaj się z przewodnikiem Integracja subskrypcji z ratami.

Przechodzenie z Biblioteki płatności w Play w wersji 6 na Bibliotekę płatności w Play w wersji 7

W sekcjach poniżej znajdziesz opis przejścia z Biblioteki płatności w Play w wersji 6 na Bibliotekę płatności w Play w wersji 7.

Aktualizacja Biblioteki płatności w Google Play

Zaktualizuj wersję zależności Biblioteki płatności w Play w pliku build.gradle aplikacji.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Następnie zaktualizuj odwołania do interfejsu API zgodnie z opisem w sekcjach poniżej.

Obsługa zmian w interfejsie API związanych z subskrypcjami

Wycofane wcześniej interfejsy API setOldSkuPurchaseToken, setReplaceProrationMode i setReplaceSkusProrationMode zostały usunięte.

Obsługa usuniętych interfejsów API do rozliczeń alternatywnych

Usunięto BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener i AlternativeChoiceDetails. Deweloperzy powinni zamiast tego używać BillingClient.Builder.enableUserChoiceBilling() z UserChoiceBillingListener i UserChoiceDetails w wywołaniu zwrotnym detektora.

Opcjonalne zmiany

Biblioteka płatności w Play w wersji 7 zawiera 2 nowe opcjonalne interfejsy API.

Obsługa oczekujących zakupów w przypadku abonamentów przedpłaconych

Zapoznaj się z przewodnikiem Obsługa subskrypcji i oczekujących transakcji.

Subskrypcje z wirtualnymi ratami

Informacje o tym, jak zintegrować te zmiany z aplikacją, znajdziesz w przewodniku Integracja subskrypcji z ratami.