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ć:
- Otwórz repozytorium GitHub.
- 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/
:
- Zastąp wartość
ISSUER_ID
identyfikatorem wydawcy Google Pay API for Passes. - Zastąp
LOYALTY_CLASS_ID
,GIFTCARD_CLASS_ID
lubOFFER_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:
GiftCardWalletObject
w metodziegenerateGiftCardWalletObject
musi mieć wartościsetIssuerName
isetTitle
, które są takie same jak wartości klasy.LoyaltyWalletObject
w metodziegenerateLoyaltyWalletObject
musi mieć wartościsetIssuerName
isetProgramName
, które są takie same jak wartości klasy.OfferWalletObject
w metodziegenerateLoyaltyWalletObject
musi mieć wartościsetIssuerName
isetTitle
, 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.