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. Atau, encoding yang paling dikenal dipilih oleh Google.

valuePattern

string

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

totpDetails

object (TotpDetails)

Detail yang digunakan untuk mengevaluasi substitusi {totp_value_n}.

alternateText

string

Teks opsional yang akan menggantikan teks default yang ditampilkan di bawah kode batang. Bidang ini ditujukan untuk nilai kode batang yang 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, nilai default akan dipilih oleh Google.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Hanya input. CATATAN: Fitur ini hanya tersedia untuk vertical transportasi umum. Kumpulan nilai kode batang awal yang berputar. Hal ini memungkinkan subset kecil kode batang disertakan dengan objek. Nilai kode batang yang terus dirotasi harus diupload dengan endpoint UploadRotatingBarcodeValues.

TotpDetails

Konfigurasi untuk substitusi 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 menghasilkan OTP.

parameters[]

object (TotpParameters)

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

TotpAlgorithm

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

TotpParameters

Konfigurasi untuk kunci dan panjang 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, 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 saat kode batang pertama valid. Kode batang akan diputar menggunakan periodMillis yang ditentukan pada RotatingBarcodeValueInfo objek.

Ini adalah tanggal/waktu format ISO 8601 yang diperpanjang, 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 adalah 20 menit 50, 52 detik setelah jam ke-23 pada 12 April 1985 dalam UTC.

1985-04-12T19:20:50.52-04:00 adalah 20 menit 50, 52 detik setelah jam ke-19 pada 12 April 1985, 4 jam sebelum UTC (waktu yang sama seketika seperti contoh di atas). Jika acara berada di New York, waktu ini akan setara dengan Waktu Musim Panas Timur (EDT). Ingatlah bahwa kompensasi bervariasi di wilayah yang mengikuti Waktu Musim Panas (atau Waktu Musim Panas), tergantung pada waktu dalam setahun.

values[]

string

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

periodMillis

string (int64 format)

Wajib. Lama waktu yang berlaku untuk setiap kode batang.