RotatingBarcode

JSON 표현
{
  "type": enum (BarcodeType),
  "renderEncoding": enum (BarcodeRenderEncoding),
  "valuePattern": string,
  "totpDetails": {
    object (TotpDetails)
  },
  "alternateText": string,
  "showCodeText": {
    object (LocalizedString)
  },
  "initialRotatingBarcodeValues": {
    object (RotatingBarcodeValues)
  }
}
필드
type

enum (BarcodeType)

이 바코드의 유형입니다.

renderEncoding

enum (BarcodeRenderEncoding)

바코드의 렌더링 인코딩입니다. 지정된 경우 지정된 인코딩으로 바코드가 렌더링됩니다. 그렇지 않으면 Google에서 가장 잘 알려진 인코딩을 선택합니다.

valuePattern

string

문자열로 인코딩된 바코드 값입니다. 이 문자열은 다음과 같은 대체를 지원합니다. * {totp_value_n}: TOTP 값으로 대체됩니다 (TotpDetails.parameters 참고). * {totp_timestamp_millis}: 바코드가 생성된 타임스탬프 (에포크 이후 밀리초)로 대체됩니다. * {totp_timestamp_seconds}: 바코드가 생성된 타임스탬프 (에포크 이후 초)로 대체됩니다.

totpDetails

object (TotpDetails)

{totp_value_n} 대체를 평가하는 데 사용되는 세부정보입니다.

alternateText

string

바코드 아래에 표시되는 기본 텍스트보다 우선 적용될 텍스트입니다(선택사항). 이 필드는 바코드 값을 사람이 읽을 수 있도록 하기 위해 사용되며 바코드를 스캔할 수 없을 때 사용됩니다.

showCodeText

object (LocalizedString)

클릭 동작 뒤에 바코드가 숨겨져 있을 때 표시되는 텍스트(선택사항)입니다. 패스에 스마트 탭이 사용 설정된 경우에 발생합니다. 지정되지 않은 경우 Google에서 기본값을 선택합니다.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

입력 전용입니다. 참고: 이 기능은 대중교통 카테고리에서만 사용할 수 있습니다. 초기 회전 바코드 값 집합(선택사항)입니다. 이렇게 하면 일부 바코드만 객체에 포함할 수 있습니다. 추가 회전 바코드 값은 UploadRotatingBarcodeValues 엔드포인트로 업로드해야 합니다.

TotpDetails

시간 기반 OTP 대체의 구성입니다. https://tools.ietf.org/html/rfc6238을 참고하세요.

JSON 표현
{
  "periodMillis": string,
  "algorithm": enum (TotpAlgorithm),
  "parameters": [
    {
      object (TotpParameters)
    }
  ]
}
필드
periodMillis

string (int64 format)

TOTP 값 생성에 사용되는 시간 간격(밀리초)입니다.

algorithm

enum (TotpAlgorithm)

OTP를 생성하는 데 사용된 TOTP 알고리즘입니다.

parameters[]

object (TotpParameters)

각 {totp_value_*} 대체 항목의 TOTP 매개변수입니다. 색인 n의 TotpParameters는 {totp_value_n} 대체에 사용됩니다.

TotpAlgorithm

열거형
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 SHA1 해시 함수를 사용한 RFC 6238의 TOTP 알고리즘

TotpParameters

키 및 값 길이의 구성입니다. https://www.rfc-editor.org/rfc/rfc4226#section-5.3을 참고하세요.

JSON 표현
{
  "key": string,
  "valueLength": integer
}
필드
key

string

TOTP 값 생성에 사용되는 비밀 키로, Base16 문자열로 인코딩됩니다.

valueLength

integer

TOTP 값의 길이(십진수)입니다.

RotatingBarcodeValues

여러 바코드 값과 시작 날짜/시간을 포함하는 페이로드입니다.

JSON 표현
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
필드
startDateTime

string

필수 항목입니다. 첫 번째 바코드의 유효 기간이 시작되는 날짜/시간입니다. 객체의 RotatingBarcodeValueInfo에 정의된 periodMillis를 사용하여 바코드가 순환됩니다.

오프셋이 포함된 ISO 8601 확장 형식 날짜/시간입니다. 시간은 나노초 단위까지 지정할 수 있습니다. 오프셋은 초 정밀도로 지정할 수 있습니다 (오프셋 초는 ISO 8601의 일부가 아님).

예를 들면 다음과 같습니다.

1985-04-12T23:20:50.52Z는 1985년 4월 12일 23시 20분 50.52초(UTC 기준)입니다.

1985-04-12T19:20:50.52-04:00은 UTC보다 4시간 늦은 1985년 4월 12일 19시 20분 50.52초입니다(위의 예시와 같은 시점). 이벤트가 뉴욕에서 진행된다면 이 시간은 미 동부 하계 표준시(EDT)에 해당합니다. 일광 절약 시간 (서머타임)을 시행하는 지역에서는 연중 시점에 따라 오프셋이 다르게 적용된다는 점에 유의하세요.

values[]

string

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

periodMillis

string (int64 format)

필수 항목입니다. 각 바코드가 유효한 시간입니다.