Google Wallet API FAQ

시작하기

Google Wallet API란 무엇인가요?

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

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

아래는 다양한 수준의 비즈니스 복잡성과 보안을 지원하는 개발 환경을 설정하는 데 사용할 수 있는 가이드입니다. 여러 서비스 계정을 사용하면 개발자가 PROD 환경과 별도의 테스트 환경을 만들 수 있습니다.

기본 설정 복잡성

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

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

평균 설정 난이도

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

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

복잡한 설정 난이도

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

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

지원팀에 문의하기

패스 사용

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

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

여러 티켓을 함께 그룹화하려면 어떻게 해야 하나요?

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

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

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

패스를 일괄적으로 만들 수 있나요?

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

일반적인 질문

Google Wallet API로 전송된 요청의 비율 제한은 무엇인가요?

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

Google 월렛 API에는 공식 SLA가 없지만, 약 5초의 99번째 백분위수 지연 시간을 기준으로 10초의 타임아웃을 권장합니다. 또한 지연 시간은 외부 서버의 지연 시간에 따라 달라지므로 해당 이미지가 있는 객체를 삽입할 때 외부 서버에 호스팅된 이미지를 가져오는 데 필요한 시간과 같은 외부 요인에 따라 달라지는 경우가 많습니다.

Google 월렛의 패스에 개인 이미지가 금지되는 이유는 무엇인가요?

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

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

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

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

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

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

판매자 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 리더가 필요한가요?

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

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

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

JSON 웹 토큰 (JWT)

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

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

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

문제 해결

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

패스에 표시되는 시간은 이벤트가 열리는 지역의 시간으로, 이벤트가 열리는 지역의 시간으로 오프셋됩니다.

내가 만든 패스에 로고가 렌더링되지 않습니다. 무엇이 잘못되었을까요?

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

지원 및 의견

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

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

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

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

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

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