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 は、1985 年 4 月 12 日の 23 時(UTC)から 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)

必須。各バーコードが有効である時間の長さ。