RotatingBarcode

Representasi JSON
{
  "type": enum (BarcodeType),
  "renderEncoding": enum (BarcodeRenderEncoding),
  "valuePattern": string,
  "totpDetails": {
    object (TotpDetails)
  },
  "alternateText": string,
  "showCodeText": {
    object (LocalizedString)
  },
  "initialRotatingBarcodeValues": {
    object (RotatingBarcodeValues)
  }
}
Kolom
type

enum (BarcodeType)

Jenis kode batang ini.

renderEncoding

enum (BarcodeRenderEncoding)

Encoding render untuk kode batang. Jika ditentukan, kode batang akan dirender dalam encoding yang diberikan. Jika tidak, encoding yang paling dikenal akan dipilih oleh Google.

valuePattern

string

Nilai kode batang yang dienkode ke string. String ini mendukung penggantian berikut: * {totp_value_n}: Diganti dengan nilai TOTP (lihat TotpDetails.parameters). * {totp_timestamp_millis}: Diganti dengan stempel waktu (milidetik sejak epoch) saat kode batang dibuat. * {totp_timestamp_seconds}: Diganti dengan stempel waktu (detik sejak epoch) saat kode batang dibuat.

totpDetails

object (TotpDetails)

Detail yang digunakan untuk mengevaluasi penggantian {totp_value_n}.

alternateText

string

Teks opsional yang akan menggantikan teks default yang ditampilkan di bawah kode batang. Kolom ini ditujukan untuk nilai kode batang yang setara dan dapat dibaca manusia, yang digunakan saat kode batang tidak dapat dipindai.

showCodeText

object (LocalizedString)

Teks opsional yang akan ditampilkan saat kode batang disembunyikan di balik tindakan klik. Hal ini terjadi jika kartu mengaktifkan Smart Tap. Jika tidak ditentukan, setelan default akan dipilih oleh Google.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Input saja. CATATAN: Fitur ini hanya tersedia untuk vertikal transportasi umum. Rangkaian nilai kode batang opsional yang berputar. Hal ini memungkinkan sebagian kecil kode batang disertakan dengan objek. Nilai kode batang yang berputar lebih lanjut harus diupload dengan endpoint UploadRotatingBarcodeValues.

TotpDetails

Konfigurasi untuk penggantian OTP berbasis waktu. Lihat https://tools.ietf.org/html/rfc6238

Representasi JSON
{
  "periodMillis": string,
  "algorithm": enum (TotpAlgorithm),
  "parameters": [
    {
      object (TotpParameters)
    }
  ]
}
Kolom
periodMillis

string (int64 format)

Interval waktu yang digunakan untuk pembuatan nilai TOTP, dalam milidetik.

algorithm

enum (TotpAlgorithm)

Algoritma TOTP yang digunakan untuk membuat OTP.

parameters[]

object (TotpParameters)

Parameter TOTP untuk setiap penggantian {totp_value_*}. TotpParameters pada indeks n digunakan untuk penggantian {totp_value_n}.

TotpAlgorithm

Enum
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 Algoritma TOTP dari RFC 6238 dengan fungsi hash SHA1

TotpParameters

Konfigurasi untuk panjang kunci dan nilai. Lihat https://www.rfc-editor.org/rfc/rfc4226#section-5.3

Representasi JSON
{
  "key": string,
  "valueLength": integer
}
Kolom
key

string

Kunci rahasia yang digunakan untuk pembuatan nilai TOTP, yang dienkode sebagai string Base16.

valueLength

integer

Panjang nilai TOTP dalam digit desimal.

RotatingBarcodeValues

Payload yang berisi banyak nilai kode batang dan tanggal/waktu mulai.

Representasi JSON
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
Kolom
startDateTime

string

Wajib. Tanggal/waktu barcode pertama valid. Kode batang akan diputar menggunakan periodMillis yang ditentukan di RotatingBarcodeValueInfo objek.

Ini adalah tanggal/waktu format tambahan ISO 8601, dengan offset. Waktu dapat ditentukan hingga presisi nanodetik. Offset dapat ditentukan dengan presisi detik (meskipun detik offset bukan bagian dari ISO 8601).

Contoh:

1985-04-12T23:20:50.52Z akan menjadi 20 menit dan 50,52 detik setelah jam ke-23 pada 12 April 1985 dalam UTC.

1985-04-12T19:20:50.52-04:00 akan menjadi 20 menit dan 50,52 detik setelah jam ke-19 pada 12 April 1985, 4 jam sebelum UTC (instan yang sama dengan contoh di atas). Jika acaranya berada di New York, waktu ini akan setara dengan Waktu Musim Panas Timur (EDT). Perlu diingat bahwa offset bervariasi di wilayah yang menerapkan Waktu Musim Panas (atau Waktu Musim Panas), bergantung pada waktu dalam setahun.

values[]

string

Wajib. Nilai yang akan dienkode dalam kode batang. Diperlukan setidaknya 1 nilai.

periodMillis

string (int64 format)

Wajib. Durasi validitas setiap kode batang.