개요

Google Wallet Pass API를 사용하면 파트너가 결제 수단을 통해 회전 중 바코드를 Google 월렛으로 전송합니다. 이 바코드는 짧은 시간 동안만 유효하므로 추가 보안 기능을 제공하여 바코드 스크린샷의 위험을 줄일 수 있습니다. 이 기기에 따라 생성된 바코드가 RFC 6238: 보안 비밀 키 하지만 파트너가 바코드를 직접 생성하려는 경우 Google은 바코드를 Google에 일괄 업로드할 수 있는 API 이 바코드는 사용자의 IP 주소를 이 케이블은 회전 바코드처럼 작동합니다. 표시됩니다. Google에서는 이 솔루션을 파트너 생성 솔루션이라고 부릅니다. 회전 바코드.

파트너 생성 회전 바코드 API

파트너가 생성한 회전 바코드가 동일한 RotatingBarcode를 사용하여 생성됩니다. 객체를 지정합니다. 유형만 필수적이지만 작은 시작 조건을 만드는 것도 좋습니다. 하나 이상의 바코드 세트 (약 10분 분량)를 보내고 initialRotatingBarcodeValues 파트너는 항상 사용자에게 유효한 바코드가 준비되고 initialRotatingBarcodeValues는 이를 통해 후속 일괄 업로드 호출을 비동기식으로 처리합니다.

  rotatingBarcode {
    initialRotatingBarcodeValues: object (RotatingBarcodeValues),
    type: enum (BarcodeType),
  }
필드 설명
initialRotatingBarcodeValues

object (RotatingBarcodeValues)

바코드에서 인코딩할 값입니다. 값을 하나 이상 입력해야 합니다. 이러한 초기 바코드는 사용자가 패스를 처음 획득한 시점과 다음 일괄 업로드가 호출될 때 생성됩니다.
type

enum (BarcodeType)

필수 항목입니다. 이 바코드의 유형입니다.

사용 가능한 값:

  • QR_CODE
  • PDF_417
RotatingBarcodeValues
필드 설명
startDateTime

string

첫 번째 바코드가 유효한 날짜/시간입니다. 바코드가 스캔된 periodMillis 사용.

오프셋이 포함된 ISO 8601 확장 형식 날짜/시간입니다.
values[]

string

바코드에서 인코딩할 값입니다. 값을 하나 이상 입력해야 합니다.

값의 개수에는 제한이 없지만 요청 본문의 크기는 5MB를 초과할 수 없습니다.
periodMillis

number

각 바코드가 유효한 시간입니다.

바코드 값 일괄 업데이트

RotatingBarcode 객체가 생성되면 하루 동안의 100%의 바코드를 매일 스캔합니다. 이 작업은 다음 REST API 엔드포인트를 가져옵니다.

메서드: transitobject.uploadrotatingbarcodevalues

지정된 객체 ID로 참조되는 대중교통 객체에 순환 바코드 값을 업로드합니다.

HTTP 요청

POST https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc eId}/uploadRotatingBarcodeValues

경로 매개변수

매개변수 설명
resourceId

string

객체의 고유 식별자입니다.

요청 본문

요청 본문 (5MB를 초과할 수 없음)에는 RotatingBarcodeValues입니다.

메서드: transitobject.downloadrotatingbarcodevalues

지정된 객체에서 참조한 대중교통 객체의 순환 바코드 값을 다운로드합니다. 있습니다. 이는 파트너가 최신 배치를 확인하려는 경우에 유용합니다.

HTTP 요청

GET https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do wnloadRotatingBarcodeValues?alt=media

경로 매개변수

매개변수 설명
resourceId

string

객체의 고유 식별자입니다.

대체 메커니즘

다른 방식으로 유효한 RotatingBarcode에 표시할 유효한 바코드가 없는 경우( 업로드되지 않았거나 현재 바코드가 모두 사용된 경우) 사용자에게 표시됩니다.