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

10진수로 표시된 TOTP 값의 길이입니다.

RotatingBarcodeValues

다수의 바코드 값과 시작 날짜/시간을 포함한 페이로드

JSON 표현
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
입력란
startDateTime

string

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

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

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

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

1985-04-12T19:20:50.52-04:00은 UTC보다 4시간 늦은 1985년 4월 12일 19시 20분 50.52초입니다 (위 예와 같은 시점). 이벤트가 뉴욕에서 진행된다면 이 시간은 미 동부 일광 절약 시간 (EDT)에 해당합니다. 일광 절약 시간 (서머 타임)이 적용되는 지역에서는 연중 시기에 따라 오프셋이 달라질 수 있습니다.

values[]

string

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

periodMillis

string (int64 format)

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