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)

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