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 RFC 6238 の TOTP アルゴリズム(SHA1 ハッシュ関数を使用)

TotpParameters

キーと値の長さの構成。https://www.rfc-editor.org/rfc/rfc4226#section-5.3 をご覧ください。

JSON 表現
{
  "key": string,
  "valueLength": integer
}
フィールド
key

string

TOTP 値の生成に使用される秘密鍵。Base16 文字列としてエンコードされます。

valueLength

integer

TOTP 値の長さ(10 進数)。

RotatingBarcodeValues

多数のバーコード値と開始日時を含むペイロード。

JSON 表現
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
フィールド
startDateTime

string

必須。最初のバーコードが有効になる日付/時刻。バーコードは、オブジェクトの RotatingBarcodeValueInfo で定義された periodMillis を使用してローテーションされます。

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 は、1985 年 4 月 12 日の 19 時 20 分 50.52 秒(UTC の 4 時間前)です(上記の例と同じ時刻です)。イベントがニューヨークで行われた場合、これは東部夏時間(EDT)に相当します。夏時間が適用されるリージョンでは、時期によってオフセットが変わることに留意してください。

values[]

string

必須。バーコードでエンコードする値。値を少なくとも 1 つ指定してください。

periodMillis

string (int64 format)

必須。各バーコードの有効期間。