Google Pay API for Passes를 위한 Android API를 사용하면 사용자가 클릭 한 번으로 패스 객체를 Google Pay에 저장할 수 있습니다. 이 빠른 시작 예시에서는 포인트, 기프트카드, 쿠폰 객체를 저장하기 위한 간단한 설정을 제공합니다.
Android SDK 가이드에 따른 후 다음 단계에 따라 샘플 Android 앱을 실행하세요.
1단계: Android 앱 설정
빠른 시작은 GitHub에서 다운로드할 수 있는 오픈소스 프로젝트입니다. 이 프로젝트를 다운로드하려면 다음 안내를 따르세요.
- GitHub 저장소로 이동합니다.
- zip 파일을 다운로드하거나
git clone https://github.com/google-pay/s2gp-quickstart-android를 실행하여 저장소를 클론합니다.
이렇게 하면 Android 스튜디오에서 샘플 앱을 기존 프로젝트로 열 수 있습니다. 동기화를 해야 프로젝트가 제대로 컴파일될 수도 있습니다. Android 스튜디오에서 샘플 앱을 빌드하고 나면 Android 기기나 에뮬레이터에서 실행할 수 있습니다.
2단계: 클래스 만들기
Google Pay API for Passes 판매자에서 클래스를 만들 수 있습니다. 판매자 센터의 'Classes(클래스)' 페이지에서 'Create Class(클래스 만들기)'를 선택하여 클래스를 만듭니다. 빨간색 윤곽선이 있는 입력 필드는 필수 항목이고 나머지 필드는 선택사항입니다. URL이 있는 필드의 경우 링크에 공개적으로 액세스할 수 있는지 확인합니다. 이렇게 만든 클래스는 패스 객체를 만들 때 참조됩니다.
3단계: Android 앱 구성
샘플 앱이 제대로 작동하도록 구성하려면 특정 값을 조정해야 합니다. app/res/values/에 있는 strings.xml에서 다음을 수행합니다.
ISSUER_ID값을 개발자의 Google Pay API for Passes 발급기관 ID로 대체합니다.LOYALTY_CLASS_ID,GIFTCARD_CLASS_ID,OFFER_CLASS_ID를 Google Pay API for Passes 판매자 센터에 이미 만든 해당 클래스의 이름으로 대체합니다.
MainActivity.java에서 각 객체 유형의 특정 값은 판매자 센터의 클래스 및 객체 참조와 일치하도록 구성되어야 합니다.
generateGiftCardWalletObject메서드에서GiftCardWalletObject의 경우setIssuerName과setTitle이 클래스의 값과 일치해야 합니다.generateLoyaltyWalletObject메서드에서LoyaltyWalletObject의 경우setIssuerName과setProgramName이 클래스의 값과 일치해야 합니다.generateLoyaltyWalletObject메서드에서OfferWalletObject의 경우setIssuerName과setTitle이 클래스의 값과 일치해야 합니다.
4단계: Android 앱 테스트
애플리케이션은 에뮬레이터나 실제 Android 기기를 통해 실행할 수 있습니다. Gradle이 제대로 동기화되면 Android 스튜디오를 통해 앱을 실행하고 원하는 배포 대상을 선택합니다. 배포가 완료되면 샘플 앱이 자동으로 출시됩니다.