Wymagania wstępne

Zanim rozpoczniesz integrację z Google Wallet API, wykonaj te czynności:

1. Rejestracja konta wydawcy w Portfelu Google dla interfejsów API

Do tworzenia i dystrybucji kart z Portfela Google jest wymagane konto wydawcy. Aby założyć konto wydawcy, zarejestruj się w Konsoli usług Google Pay i Portfela Google. Po zarejestrowaniu się otwórz stronę Google Wallet API i kliknij Utwórz pierwszą kartę. Gdy zaakceptujesz warunki korzystania z usługi, możesz zacząć tworzyć klasę karty.

Po wykonaniu powyższych czynności możesz też wypróbować Ćwiczenia z programowania.

2. Zapoznanie się z tworzeniem aplikacji na platformie Android

Na potrzeby tego samouczka poznasz podstawowe zagadnienia i umiejętności związane z tworzeniem aplikacji na platformę Android. Jeśli przed rozpoczęciem chcesz uzyskać informacje o programowaniu aplikacji na Androida, weź udział w szkoleniach dla deweloperów aplikacji na Androida.

3. Uzyskiwanie danych logowania do autoryzowania aplikacji

Aby korzystać z interfejsu API Portfela Google na Androida w aplikacji na Androida, musisz autoryzować swoją aplikację. Możesz to zrobić odciskiem cyfrowym SHA1 w kluczu programisty i nazwą pakietu.

Aby zatwierdzić swoją aplikację, musisz uzyskać odcisk cyfrowy SHA1 certyfikatu. Aby znaleźć ten odcisk palca, otwórz okno terminala i uruchom narzędzie Keytool: 

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

Magazyn kluczy debugowania zwykle znajduje się pod adresem ~/.android/debug.keystore, a jego hasło to android.

Keytool drukuje odcisk cyfrowy w powłoce. Przykład: 

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

Skopiuj odcisk cyfrowy SHA1 wyróżniony w poprzednim przykładzie. Do autoryzacji aplikacji wymagany jest odcisk cyfrowy i nazwa pakietu aplikacji. Aplikację można autoryzować, kontaktując się z zespołem pomocy przy użyciu widżetu kontaktu z zespołem pomocy Business Console.

4. Skonfiguruj Usługi Google Play

Jeśli nie masz jeszcze Android Studio, pobierz i zainstaluj Android Studio.

Portfel Google na Androida jest częścią Usług Google Play. Aby zaimportować biblioteki usług Google Play, wykonaj instrukcje konfigurowania usług Google Play.

W szczególności, aby zaimportować interfejs Google Wallet API na Androida, do pliku build.gradle w module aplikacji dodaj do pliku zależności: 

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

5. Utwórz klasę kart

Zanim utworzysz i dodasz kartę lojalnościową, musisz utworzyć LoyaltyClass. Aby to zrobić, zaloguj się w Konsoli usług Google Pay i Portfela Google, otwórz stronę Google Wallet API i utwórz nową domenę LoyaltyClass.

  1. Sprawdź, czy znajdujesz się na karcie Zarządzaj.
  2. Jeśli tworzysz kartę po raz pierwszy, zobaczysz komunikat „Jesteś w trybie demonstracyjnym”.
  3. W trybie demonstracyjnym kliknij „Skonfiguruj konta testowe”, aby dodać konta testowe. W trybie demonstracyjnym tylko konta te mogą zapisywać karty.
  4. Kliknij Utwórz zajęcia.
  5. Wybierz Lojalność.
  6. Wypełnij wszystkie wymagane pola oznaczone gwiazdką *.
  7. Kliknij Utwórz zajęcia.

Powtórz powyższe kroki, jeśli potrzebujesz wielu kart lojalnościowych.

Po utworzeniu LoyaltyClass możesz przejść do dodawania kart do Portfela Google.