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 値の長さ(小数点以下)。

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 は、1985 年 4 月 12 日の 19 時 20 分 50.52 秒(UTC の 4 時間前)です(上記の例と同じ時刻を表します)。このイベントがニューヨークで開催されていた場合、これはアメリカ東部夏時間(EDT)に相当します。夏時間を実施しているリージョンでは、年内の時期に応じてオフセットが異なるので注意してください。

values[]

string

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

periodMillis

string (int64 format)

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