Przygotowuję

W tym artykule znajdziesz listę i opis czynności, które musisz wykonać, zanim zaczniesz sprzedawać produkty w aplikacji. Ogólnie rzecz biorąc, konfiguracja obejmuje utworzenie konta dewelopera, utworzenie i skonfigurowanie produktów, które chcesz sprzedawać, oraz włączenie i skonfigurowanie interfejsów API, których używasz do sprzedaży i zarządzania produktami. Opisujemy też, jak skonfigurować powiadomienia dla deweloperów w czasie rzeczywistym, aby otrzymywać powiadomienia o każdej zmianie stanu produktu.

Zakładanie konta dewelopera w Google Play

Aby publikować aplikacje i gry w Google Play, używaj Konsoli Google Play. W Konsoli Google Play możesz też zarządzać produktami i ustawieniami związanymi z płatnościami.

Aby uzyskać dostęp do Konsoli Google Play, musisz skonfigurować konto dewelopera w Google Play.

Aby sprzedawać w Google Play płatne aplikacje i produkty w aplikacji, musisz też skonfigurować profil w Centrum płatności Google, a następnie połączyć go z kontem dewelopera w Google Play. Aby dowiedzieć się, jak połączyć profil z kontem lub jak sprawdzić, czy masz już połączone konto i profil, przeczytaj artykuł Łączenie konta dewelopera w Google Play z profilem płatności.

Włączanie funkcji związanych z płatnościami w Konsoli Google Play

Po skonfigurowaniu konta dewelopera musisz opublikować wersję aplikacji, która zawiera Bibliotekę płatności w Google Play. Ten krok jest wymagany, aby włączyć w Konsoli Google Play funkcje związane z płatnościami, takie jak konfigurowanie produktów, które chcesz sprzedawać.

Dodawanie zależności biblioteki

Aby zintegrować system rozliczeniowy Google Play, najpierw dodaj zależność do Biblioteki płatności w Google Play w swojej aplikacji. Ta biblioteka zapewnia dostęp do interfejsów API Androida, które łączą Cię z Google Play. Możesz tam uzyskać dostęp do informacji o zakupach, wysyłać zapytania o aktualizacje dotyczące zakupów, zachęcać użytkownika do dokonywania nowych zakupów i wykonywać inne czynności.

Biblioteka płatności w Google Play jest dostępna w repozytorium Maven Google. Dodaj zależność do pliku build.gradle aplikacji, jak pokazano poniżej:

dependencies {
    def billing_version = "8.3.0"

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

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

Jeśli używasz języka Kotlin, moduł Biblioteka płatności w Play KTX zawiera rozszerzenia Kotlin i obsługę współprogramów, które umożliwiają pisanie idiomatycznego kodu Kotlin podczas korzystania z systemu rozliczeniowego Google Play. Aby uwzględnić te rozszerzenia w projekcie, dodaj do pliku build.gradle aplikacji tę zależność:

dependencies {
    def billing_version = "8.3.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

dependencies {
    val billing_version = "8.3.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

Przykłady kodu w Kotlinie na tej stronie korzystają z KTX, gdy jest to możliwe.

Przesyłanie aplikacji

Po dodaniu biblioteki do aplikacji skompiluj i opublikuj aplikację. Aby to zrobić, utwórz aplikację, a następnie opublikuj ją na dowolnej ścieżce, w tym na ścieżce testu wewnętrznego.

Tworzenie i konfigurowanie produktów

Po włączeniu funkcji Płatności w Google Play w aplikacji musisz skonfigurować produkty do sprzedaży.

Procedura tworzenia produktów kupowanych raz i subskrypcji jest podobna. W przypadku każdego produktu musisz podać unikalny identyfikator produktu, tytuł, opis i informacje o cenie. Subskrypcje wymagają dodatkowych informacji, takich jak wybór typu odnowienia abonamentu podstawowego (odnawianie automatyczne lub przedpłata).

Konsola Google Play udostępnia interfejs internetowy, za pomocą którego możesz zarządzać produktami.

• Aby utworzyć i skonfigurować produkty kupowane raz, przeczytaj artykuł Tworzenie produktu zarządzanego. Pamiętaj, że w Konsoli Google Play produkty kupowane raz są nazywane produktami zarządzanymi.

• Aby utworzyć i skonfigurować subskrypcje, przeczytaj artykuł Tworzenie subskrypcji.

Zamiast interfejsu internetowego możesz też zarządzać produktami za pomocą zasobu REST inappproducts dla produktów w aplikacji i zasobu REST monetization.subscriptions dla produktów subskrypcyjnych w interfejsie Google Play Developer API.

Konfigurowanie interfejsu Google Play Developer API

Interfejs Google Play Developer API to interfejs między serwerami, który uzupełnia Bibliotekę płatności w Google Play na Androidzie. Ten interfejs API udostępnia funkcje, które nie są dostępne w Bibliotece płatności w Google Play, takie jak bezpieczne weryfikowanie zakupów i wydawanie zwrotów środków użytkownikom.

W ramach wdrażania systemu rozliczeniowego Google Play w aplikacji musisz skonfigurować dostęp do interfejsu Google Play Developer API w Konsoli Play. Instrukcje znajdziesz w artykule Wprowadzenie do interfejsu Google Play Developer API.

Po skonfigurowaniu dostępu do interfejsu Google Play Developer API upewnij się, że masz uprawnienie Wyświetlanie danych finansowych, które jest potrzebne do uzyskania dostępu do funkcji związanych z płatnościami. Informacje o sprawdzonych metodach i konfigurowaniu uprawnień znajdziesz w artykule Dodawanie użytkowników konta dewelopera i zarządzanie uprawnieniami.

Konfigurowanie powiadomień w czasie rzeczywistym dla deweloperów

Powiadomienia w czasie rzeczywistym dla deweloperów (RTDN) to mechanizm odbierania powiadomień od Google, gdy zmienią się uprawnienia użytkownika w aplikacji. RTDN korzysta z usługi Google Cloud Pub/Sub, która umożliwia odbieranie danych przesyłanych do ustawionego przez Ciebie adresu URL lub pobieranych za pomocą biblioteki klienta. Te powiadomienia umożliwiają natychmiastowe reagowanie na zmiany stanu subskrypcji, dzięki czemu nie musisz odpytywać interfejsu Google Play Developer API. Pamiętaj, że nieefektywne korzystanie z interfejsu Google Play Developer API może prowadzić do ograniczeń dotyczących limitu interfejsu API.

Cloud Pub/Sub to w pełni zarządzana usługa do przesyłania wiadomości w czasie rzeczywistym, która umożliwia wysyłanie i odbieranie wiadomości między niezależnymi aplikacjami. Google Play używa Cloud Pub/Sub do publikowania powiadomień push w tematach, które subskrybujesz.

Aby otrzymywać powiadomienia, musisz utworzyć serwer backendu, który będzie odbierać wiadomości wysyłane do Twojego tematu. Serwer może następnie wykorzystać te wiadomości, odpowiadając na żądania HTTPS wysyłane do zarejestrowanego punktu końcowego lub korzystając z bibliotek klienta Cloud Pub/Sub. Biblioteki te są dostępne w wielu językach. Więcej informacji znajdziesz też w sekcji Tworzenie subskrypcji Pub/Sub w tym temacie.

Określanie cen i limitów

Szczegółowe informacje o cenach i limitach znajdziesz w sekcjach Ceny i Limity.

Szacowanie użycia danych

Część danych powiadomienia o subskrypcji to około 1 KB danych na żądanie. Każde opublikowanie i pobranie wymaga osobnego żądania lub około 2 KB danych na powiadomienie. Liczba powiadomień w miesiącu zależy od cyklu rozliczeniowego i zachowania użytkowników. W każdym cyklu rozliczeniowym użytkownik powinien otrzymać co najmniej 1 powiadomienie.

Konfigurowanie Cloud Pub/Sub

Aby włączyć powiadomienia w czasie rzeczywistym dla deweloperów, musisz najpierw skonfigurować Cloud Pub/Sub za pomocą własnego projektu Google Cloud Platform (GCP), a następnie włączyć powiadomienia w aplikacji.

Aby korzystać z Cloud Pub/Sub, musisz mieć projekt GCP z włączonym interfejsem Cloud Pub/Sub API. Jeśli nie znasz GCP i Cloud Pub/Sub, zapoznaj się z przewodnikiem Szybki start.

Tworzenie tematu

Aby zacząć otrzymywać powiadomienia, musisz utworzyć temat, na który Google Play będzie publikować powiadomienia. Aby utworzyć temat, postępuj zgodnie z instrukcjami w sekcji Tworzenie tematu.

Tworzenie subskrypcji Pub/Sub

Aby otrzymywać wiadomości publikowane w temacie, musisz utworzyć subskrypcję Pub/Sub tego tematu. Aby utworzyć subskrypcję Pub/Sub, wykonaj te czynności:

1. Zapoznaj się z przewodnikiem subskrybenta Cloud Pub/Sub, aby określić, czy skonfigurować subskrypcję jako subskrypcję push czy subskrypcję pull.
   • Subskrypcja push umożliwia usłudze Cloud Pub/Sub wysyłanie powiadomień do bezpiecznego backendu przez wysyłanie żądań HTTPS.
   • Subskrypcja typu pull wymaga, aby bezpieczny serwer backendu inicjował żądania do serwera Cloud Pub/Sub w celu pobierania wiadomości.
2. Aby utworzyć subskrypcję, postępuj zgodnie z instrukcjami w artykule Dodawanie subskrypcji.

Przyznawanie praw do publikowania w temacie

Cloud Pub/Sub wymaga przyznania Google Play uprawnień do publikowania powiadomień w Twoim temacie.

1. Otwórz konsolę Google Cloud.
2. Wybierz projekt, a następnie w menu nawigacyjnym po lewej stronie kliknij Pub/Sub.

3. Znajdź temat i otwórz szczegóły uprawnień.

   

4. Dodaj konto usługi google-play-developer-notifications@system.gserviceaccount.com i przypisz do niego rolę publikującego w Pub/Sub.

   

5. Aby zakończyć konfigurację zestawu tematów, kliknij Zapisz.

   

Włącz powiadomienia w czasie rzeczywistym dla deweloperów w przypadku swojej aplikacji

Aby włączyć powiadomienia w czasie rzeczywistym dla deweloperów w przypadku aplikacji:

1. Otwórz Konsolę Google Play.
2. Wybierz swoją aplikację.
3. Kliknij Zarabianie > Konfiguracja ustawień zarabiania.

4. Przewiń do sekcji Powiadomienia w czasie rzeczywistym dla deweloperów u góry strony.

   .

5. Zaznacz Włącz powiadomienia w czasie rzeczywistym.

6. W polu Nazwa tematu wpisz pełną nazwę tematu Cloud Pub/Sub, który został wcześniej skonfigurowany. Nazwa tematu powinna mieć format projects/{project_id}/topics/{topic_name}, gdzie project_id to unikalny identyfikator projektu, a topic_name to nazwa utworzonego wcześniej tematu.

7. Aby wysłać wiadomość testową, kliknij Wyślij wiadomość testową. Przeprowadzenie testowej publikacji pomaga upewnić się, że wszystko jest prawidłowo skonfigurowane. Jeśli testowe opublikowanie się powiedzie, pojawi się komunikat informujący o tym, że testowe opublikowanie się udało. Jeśli masz dołączoną subskrypcję tego tematu, powinna do Ciebie dotrzeć wiadomość testowa.

   W przypadku subskrypcji typu pull otwórz subskrypcję w konsoli Cloud, kliknij Wyświetl wiadomości i pobierz wiadomości. Musisz potwierdzić każdą pobraną wiadomość, aby uniknąć jej ponownego dostarczenia przez Cloud Pub/Sub. W przypadku subskrypcji push sprawdź, czy wiadomość testowa została dostarczona do punktu końcowego push. Kod odpowiedzi oznaczający powodzenie będzie służyć jako potwierdzenie odbioru wiadomości.

   Jeśli publikacja się nie powiedzie, pojawi się błąd. Sprawdź, czy nazwa tematu jest prawidłowa i czy google-play-developer-notifications@system.gserviceaccount.comkonto usługi ma dostęp do tematu z rolą Publikujący w Pub/Sub.

8. Wybierz typy powiadomień, które chcesz otrzymywać.

   • Otrzymuj powiadomienia o subskrypcjach i wszystkich unieważnionych zakupach – otrzymuj powiadomienia w czasie rzeczywistym dla deweloperów dotyczące subskrypcji i unieważnionych zakupów. Nie będziesz otrzymywać powiadomień o zakupach produktów kupowanych raz.
   • Otrzymuj wszystkie powiadomienia o subskrypcjach i produktach kupowanych raz – otrzymuj powiadomienia o wszystkich subskrypcjach i unieważnionych zakupach. Otrzymasz też zdarzenia zakupu produktów kupowanych raz, takie jak ONE_TIME_PRODUCT_PURCHASED i ONE_TIME_PRODUCT_CANCELED. Więcej informacji o tych zdarzeniach zakupu znajdziesz w artykule Cykl życia zakupu jednorazowego.

9. Kliknij Zapisz zmiany.

Weryfikowanie konfiguracji

Aby otrzymywać powiadomienia w czasie rzeczywistym dla deweloperów, musisz utworzyć bezpieczny serwer backendu, który będzie odbierać wiadomości wysyłane do Twojego tematu Cloud Pub/Sub.

Możesz przetestować konfigurację, klikając przycisk Wyślij wiadomość testową w Konsoli Google Play, jak opisano w poprzedniej sekcji. Jeśli nie masz skonfigurowanego serwera backendu do odbierania powiadomień, możesz użyć narzędzia wiersza poleceń gcloud, aby sprawdzić konfigurację. Instrukcje dotyczące przetwarzania wiadomości za pomocą gcloud znajdziesz w artykule Pobieranie wiadomości z subskrypcji.

Dalsze kroki

• Integrowanie biblioteki z aplikacją