Krótki przewodnik dotyczący interfejsu Android API w Google Pay API for Passes

Interfejs Android API w Google Pay API for Passes pozwala jednym kliknięciem zapisywać w Google Pay obiekty z zasobami wartościowymi. Ten przykładowy krótki przewodnik pokazuje, jak w łatwy sposób zapisywać obiekty kart lojalnościowych, kart podarunkowych i ofert specjalnych.

Wykonaj instrukcje z przewodnika dotyczącego pakietu Android SDK, a potem wykonaj poniższe czynności, aby uruchomić przykładową aplikację na Androida:

Krok 1. Konfigurowanie aplikacji na Androida

Krótki przewodnik jest dostępny w formie projektu open source, który możesz pobrać z GitHuba. Aby go pobrać:

  1. Otwórz repozytorium GitHub.
  2. Pobierz plik zip lub skopiuj repozytorium za pomocą polecenia git clone https://github.com/google-pay/s2gp-quickstart-android.

Przykładową aplikację można otworzyć w Android Studio jako istniejący projekt. Do poprawnej kompilacji może być konieczne zsynchronizowanie projektu. Po skompilowaniu aplikacji w Android Studio można ją uruchomić na urządzeniu z Androidem lub w emulatorze.

Krok 2. Tworzenie klasy

Klasę można utworzyć za pomocą Google Pay API for Passes Merchant Center. Na stronie klas w Merchant Center wybierz Utwórz klasę, aby utworzyć klasę. Pola do wprowadzania danych z czerwonym konturem są wymagane. Pozostałe pola są opcjonalne. Linki pól z adresami URL muszą być publicznie dostępne. Utworzona klasa zostanie przywołana podczas tworzenia obiektu z zasobem wartościowym.

Krok 3. Konfigurowanie aplikacji na Androida

Aby przykładowa aplikacja działała poprawnie, musisz zmienić pewne wartości. W obiekcie strings.xml znalezionym w app/res/values/:

  1. Zastąp wartość ISSUER_ID identyfikatorem wydawcy Google Pay API for Passes.
  2. Zastąp LOYALTY_CLASS_ID, GIFTCARD_CLASS_ID lub OFFER_CLASS_ID nazwą klasy utworzonej na koncie Google Pay API for Passes Merchant Center.

W MainActivity.java musisz ustawić pewne wartości typów obiektów zgodnie z odwołaniami do klas i obiektów w Merchant Center:

  1. GiftCardWalletObject w metodzie generateGiftCardWalletObject musi mieć wartości setIssuerName i setTitle, które są takie same jak wartości klasy.
  2. LoyaltyWalletObject w metodzie generateLoyaltyWalletObject musi mieć wartości setIssuerName i setProgramName, które są takie same jak wartości klasy.
  3. OfferWalletObject w metodzie generateLoyaltyWalletObject musi mieć wartości setIssuerName i setTitle, które są takie same jak wartości klasy.

Krok 4. Testowanie aplikacji na Androida

Aplikację możesz uruchomić w emulatorze lub na fizycznym urządzeniu z Androidem. Po zsynchronizowaniu Gradle uruchom aplikację w Android Studio i wybierz cel wdrożenia. Gdy wdrażanie zakończy się, przykładowa aplikacja powinna się uruchomić automatycznie.