Google Wallet API FAQ

시작하기

Google Wallet API란 무엇인가요?

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

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

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

기본 설정 복잡성

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

  • 이 옵션을 사용하면 기본 계정 1개를 사용하는 중앙 관리 방식을 사용할 수 있고, 하위 비즈니스/발행자가 0개 이상일 수도 있습니다.
  • Google Cloud 프로젝트 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 Wallet API에서는 어떤 오류 코드가 반환되나요?

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

푸시 알림을 활성화하려면 어떻게 하나요?

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

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

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

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

앱 링크 기능을 사용하려면 어떻게 해야 하나요?

앱 연결을 위해서는 허용 목록이 필요하며 여기에서 요청할 수 있습니다.

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

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

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

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

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

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

Base64로 인코딩된 userProfile 데이터를 올바르게 처리하는 방법

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

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

API를 통해 발급기관 계정을 만들려면 이 가이드를 참조하세요.

스마트 탭

Google SmartTap 패스를 사용하려면 특수 NFC 리더가 필요한가요?

SmartTap 지원 단말기여야 합니다. 인증된 제공업체 목록은 여기에서 확인할 수 있습니다.

NFC에서 패스를 사용하려면 어떻게 해야 하나요?

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

JSON 웹 토큰 (JWT)

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

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

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

문제 해결

시간 설정에 따라 일정의 시간이 잘못 표시되는 이유는 무엇인가요?

패스에 표시되는 시간은 이벤트의 현지 시간으로, 이벤트가 발생한 시간에 대한 오프셋이 포함됩니다.

빌드한 패스에서 로고가 렌더링되지 않습니다. 무엇이 문제인가요?

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

지원 및 의견

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

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

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

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

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

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