Google Wallet API FAQ

시작하기

Google Wallet API란 무엇인가요?

Google Wallet API를 사용하면 개발자가 Google 월렛에서 디지털 패스를 만들 수 있습니다. Google Wallet API는 현재 탑승권, 이벤트 티켓, 포인트 카드, 혜택, 대중교통 이용권을 지원합니다. 최근에는 추가 사용 사례를 지원하기 위해 일반 패스 유형이 추가되었습니다.

비즈니스 요구사항과 복잡도에 따라 개발 환경을 설정하려면 어떻게 해야 하나요?

다음은 다양한 수준의 비즈니스 복잡성과 보안에 적합한 개발 환경을 설정하는 데 사용할 수 있는 가이드입니다. 개발자는 여러 서비스 계정을 사용하여 PROD 환경과 별도의 TEST 환경을 만들 수 있습니다.

기본 설정 복잡성

1개의 비즈니스 콘솔 계정 또는 1개의 비즈니스 콘솔 상위 계정을 여러 발급자 계정에 연결할 수 있습니다.

  • 이 옵션을 사용하면 하나의 기본 계정을 사용하여 0개부터 여러 하위 비즈니스/발급기관을 갖는 중앙 관리형 접근 방식을 사용할 수 있습니다.
  • Google Cloud 프로젝트 1개.
  • 서비스 계정 사용자 인증 정보 1개
  • 단일 사용자 집합

평균 설정 복잡성

1개의 상위 계정과 여러 발급자 계정

  • 이 옵션을 사용하면 여러 하위 비즈니스가 있는 하나의 기본 계정을 사용하여 중앙에서 관리하는 접근 방식을 사용할 수 있습니다.
  • Google Cloud 프로젝트 1개
  • 발급기관별로 고유한 비즈니스 콘솔 사용자 수
  • 1대다 서비스 계정 사용자 인증 정보
    • 비즈니스/발급기관당 사용자 인증 정보 1개입니다.
    • 비즈니스별로 다른 사용자 인증 정보 액세스 권한

복잡한 설정 복잡성

1개의 상위 계정과 여러 발급자 계정

  • 이 옵션을 사용하면 여러 하위 비즈니스가 있는 하나의 기본 계정을 사용하여 중앙에서 관리하는 접근 방식을 사용할 수 있습니다.
  • 하나 이상의 Google Cloud 프로젝트.
  • 발급기관별 고유한 비즈니스 콘솔 사용자입니다.
  • 1대다 서비스 계정 사용자 인증 정보
    • 비즈니스/발급기관당 PROD 사용자 인증 정보 1개입니다.
    • 비즈니스/발급자당 DEV 사용자 인증 정보 1개

지원팀에 문의하기

패스 작업

클래스 또는 객체를 삭제하려면 어떻게 해야 하나요?

현재 Google 월렛에서는 클래스나 객체를 삭제할 수 없습니다. 하지만 사용자는 Google 월렛에서 항목의 연결을 해제할 수 있습니다.

여러 개의 패스를 함께 그룹화하려면 어떻게 해야 하나요?

GroupingID를 사용하면 패스를 쉽게 그룹화할 수 있습니다.

패스의 일부만 업데이트하려면 어떻게 해야 하나요?

PATCH 요청을 사용하여 부분 업데이트를 실행하는 방법을 알아보려면 성능 가이드를 따르세요.

패스를 일괄 생성할 수 있나요?

성능 가이드에 따라 API를 사용하여 일괄 요청을 실행하는 방법을 알아보세요.

일반적인 질문

Google Wallet API로 전송되는 요청의 비율 제한은 얼마인가요?

Google Wallet API 호출은 초당 20개 요청으로 비율이 제한됩니다.

Google 월렛의 패스에 개인 이미지를 사용할 수 없는 이유는 무엇인가요?

현재 규정에서는 모든 소비자가 민감한 정보의 수집 또는 처리를 거부할 권리가 있다고 명시되어 있으므로 Google 월렛은 패스에 개인 이미지를 지원하지 않습니다. 민감한 정보(개인 이미지)를 가치 있는 객체(JWT)의 일부로 포함하면 원래 동의 계약 범위를 벗어나 데이터가 공개될 수 있다는 호스팅 문제가 발생할 수 있습니다. 데이터 기밀을 보장하기 위해 개인 이미지는 허용되지 않습니다. 향후 개인 이미지를 지원하기 위해 노력하고 있습니다.

Google Wallet API에서 반환되는 오류 코드는 무엇인가요?

Google Wallet API에서 반환하는 오류 코드 및 예외 목록은 오류 코드를 참고하세요.

푸시 알림을 사용 설정하려면 어떻게 하나요?

개발자가 작성한 푸시 알림은 현재 Google 월렛에서 지원되지 않습니다. 하지만 Google 월렛에서는 다음 패스에 대해 적시에 알림을 제공합니다. 개발자가 작성한 푸시 알림은 현재 Google 월렛에서 지원되지 않습니다.

업종 알림 트리거됨 문서
이벤트 예정된 알림 일정 3시간 전 docs
탑승권 예정된 알림 항공편 출발 3시간 전 docs
탑승권 패스 업데이트 출발지 터미널, 게이트, 탑승 시간 또는 출발 시간 변경 docs
혜택 카드 만료 알림 혜택 카드 만료 48시간 전 docs
일반 예정된 알림 '시간 간격'이 시작되기 24시간 전 문서
일반 만료 알림 '내부 시간' 종료 48시간 전 docs

판매자 ID를 삭제할 수 있나요?

현재 판매자 ID는 Google Pay 및 월렛 콘솔에서 삭제하거나 보관처리할 수 없습니다.

Applinking 기능은 어떻게 사용하나요?

Applink를 사용하려면 허용 목록에 추가해야 하며 여기에서 요청할 수 있습니다.

Google 월렛에서 지오펜싱을 지원하나요?

현재 지오펜싱은 지원되지 않습니다.

포인트 제도는 어떻게 설정하나요?

이 가이드에 따라 등록 및 포인트 제도를 설정할 수 있습니다.

Google에 대중교통 이용권 로고를 보내려면 어떻게 해야 하나요?

허용 목록에 추가할 로고를 Google에 보내려면 이 양식을 사용하세요.

Base64로 인코딩된 userProfile 데이터를 올바르게 처리하려면 어떻게 해야 하나요?

프로세스 전체에서 UTF-8 인코딩을 사용해야 합니다. JSON 문자열은 먼저 UTF-8로 인코딩된 후 NO_WRAP 및 URL_SAFE 옵션을 사용하여 android.util.Base64로 인코딩됩니다. 이는 RFC 3548 4조에 부합합니다.

프로그래매틱 방식으로 발급기관 계정을 만들려면 어떻게 해야 하나요?

이 가이드를 참고하여 API를 통해 발급기관 계정을 만드세요.

스마트 탭

Google SmartTap 패스에 특별한 NFC 리더가 필요한가요?

스마트 탭을 지원하는 단말기여야 합니다. 인증된 제공업체 목록은 여기에서 확인할 수 있습니다.

패스를 NFC와 호환되도록 하려면 어떻게 해야 하나요?

패스를 스마트 탭으로 사용할 수 있도록 하려면 이 구성을 따르세요.

JSON 웹 토큰(JWT)

JWT 구현과 디버깅을 간소화하는 도구가 있나요?

예. www.jwt.io와 같은 플랫폼을 사용하면 개발 과정에서 토큰을 디코딩하고 디버그할 수 있으므로 제출하는 콘텐츠를 확인할 수 있습니다. Google은 어떠한 서드 파티 서비스와도 제휴 관계에 있지 않으며 특별히 추천하는 서드 파티 서비스도 없습니다.

패스 저장 링크(JWT)를 만들기 전에 API를 사용하여 클래스와 객체를 미리 만들 수 있습니다.

문제 해결

시간 설정에 잘못된 이벤트 시간이 표시되는 이유는 무엇인가요?

패스에 표시된 시간은 이벤트가 발생한 시간의 오프셋과 함께 이벤트 현지 시간입니다.

내가 빌드한 패스에서 로고가 렌더링되지 않습니다. 어떤 문제가 발생할 수 있을까요?

  • 먼저 로고가 가이드라인을 따르고 PNG 형식으로 저장되어 있는지 확인합니다.
  • 로고를 안정적으로 사용할 수 있는지 확인합니다. 404 오류가 발생할 수 있는 이미지 파일로 리디렉션하지 마세요. 이미지는 HTTPS 위치에서 호스팅되어야 하며, 그렇지 않으면 Google 월렛에 표시되지 않습니다.
  • API에서 필수로 표시된 모든 필수 필드가 패스에 설정되었는지 확인합니다.

지원 및 의견

기술 지원팀에 문의하려면 어떻게 해야 하나요?

도움이 더 필요하면 Google Pay 및 월렛 콘솔의 왼쪽 사이드바에 있는 '지원팀에 문의' 버튼을 클릭하여 지원팀에 문의하세요.

제품에 대한 의견을 남기려면 어떻게 해야 하나요?

제품에 관한 의견을 남기려면 개발자 사이트 페이지의 오른쪽 상단 사분면에 있는 '의견 보내기' 버튼을 클릭하고 '제품 의견'을 선택하세요. 그런 다음 텍스트 영역에 의견을 설명하고 '보내기'를 클릭합니다.

문서에 대한 의견을 남기려면 어떻게 해야 하나요?

문서에 관한 의견을 남기려면 개발자 사이트 페이지의 오른쪽 상단 사분면에 있는 '의견 보내기' 버튼을 클릭하고 '문서 관련 의견'을 선택하세요. 그런 다음 텍스트 영역에 의견을 작성하고 '보내기'를 클릭합니다.