Google 월렛 패스 API는 파트너가 회전 바코드를 Google 월렛에 저장할 수 있는 기능을 제공합니다. 이러한 바코드는 짧은 시간 동안만 유효하므로 바코드 스크린샷 위험을 줄이기 위한 추가 보안을 제공합니다. 바코드는 파트너가 보안 비밀 키를 제공하는 RFC 6238에 따라 기기에서 생성됩니다. 하지만 파트너가 바코드를 직접 생성하고자 하는 경우 Google은 바코드를 Google에 일괄 업로드할 수 있는 API를 제공합니다. 그러면 이러한 바코드가 사용자의 휴대전화로 전달되어 회전 바코드처럼 작동하며 잠시 표시됩니다. Google에서는 이 솔루션을 파트너가 생성한 회전 바코드라고 합니다.
파트너가 생성한 회전 바코드 API
파트너가 생성한 회전 바코드는 동일한 RotatingBarcode 객체를 사용하여 생성됩니다. 유형만 필요하지만 시작용 바코드 세트 (약 10분 분량)를 만들어 initialRotatingBarcodeValues로 전송하는 것이 좋습니다. 파트너는 항상 사용자에게 유효한 바코드가 준비되어 있는지 확인해야 하며 initialRotatingBarcodeValues는 후속 일괄 업로드 호출을 비동기식으로 허용합니다.
rotatingBarcode {
initialRotatingBarcodeValues: object (RotatingBarcodeValues),
type: enum (BarcodeType),
}
| 필드 | 설명 |
|---|---|
initialRotatingBarcodeValues |
바코드에 인코딩할 값입니다. 값을 하나 이상 입력해야 합니다. 이러한 초기 바코드는 사용자가 처음 패스를 획득한 시점과 후속 일괄 업로드 호출이 이루어지는 시점 사이의 공백을 메우기 위한 것입니다. |
type |
필수 항목입니다. 이 바코드의 유형입니다. 사용 가능한 값:
|
| 필드 | 설명 |
|---|---|
startDateTime |
첫 번째 바코드의 유효 기간이 시작되는 날짜/시간입니다. 바코드는 오프셋이 있는 ISO 8601 확장 형식 날짜/시간입니다. |
values[] |
바코드에 인코딩할 값입니다. 값을 하나 이상 입력해야 합니다. 값의 최대 개수는 없지만 요청 본문의 크기는 5MB를 초과할 수 없습니다. |
periodMillis |
각 바코드가 유효한 시간입니다. |
바코드 값 일괄 업데이트
RotatingBarcode 객체가 생성된 후 사용자의 패스가 만료될 때까지 매일 하루치의 바코드를 업로드하는 것이 좋습니다. 다음 REST API 엔드포인트를 사용하여 이 작업을 실행할 수 있습니다.
메서드: transitobject.uploadrotatingbarcodevalues
지정된 객체 ID로 참조되는 대중교통 객체에 회전 바코드 값을 업로드합니다.
HTTP 요청
POST
https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc
eId}/uploadRotatingBarcodeValues
경로 매개변수
| 매개변수 | 설명 |
|---|---|
resourceId |
객체의 고유 식별자입니다. |
요청 본문
요청 본문 (5MB를 초과할 수 없음)에는 RotatingBarcodeValues 인스턴스가 포함됩니다.
메서드: transitobject.downloadrotatingbarcodevalues
지정된 객체 ID로 참조되는 대중교통 객체의 회전 바코드 값을 다운로드합니다. 파트너가 최신 일괄 처리를 확인하려는 경우에 유용합니다.
HTTP 요청
GET
https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do
wnloadRotatingBarcodeValues?alt=media
경로 매개변수
| 매개변수 | 설명 |
|---|---|
resourceId |
객체의 고유 식별자입니다. |