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 dipilih oleh Google.

valuePattern

string

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

totpDetails

object (TotpDetails)

Detail yang digunakan untuk mengevaluasi substitusi {totp_value_n}.

alternateText

string

Teks opsional yang akan mengganti teks default yang ditampilkan di bawah kode batang. Kolom ini ditujukan untuk nilai setara yang dapat dibaca manusia dengan nilai kode batang, 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 transit. Rangkaian nilai kode batang opsional yang berputar. Tindakan ini memungkinkan subset kecil kode batang disertakan dengan objek. Nilai kode batang rotasi lebih lanjut 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 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, 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 diisi. Tanggal/waktu kode batang pertama valid. Kode batang akan dirotasi menggunakan periodMillis yang ditentukan di RotatingBarcodeValueInfo objek.

Ini adalah tanggal/waktu format diperpanjang 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 50, 52 detik setelah jam ke-23 tanggal 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 tanggal 12 April 1985, 4 jam sebelum UTC (waktu yang sama seperti contoh di atas). Jika acaranya berada di New York, waktu ini akan setara dengan Waktu Musim Panas Timur (EDT). Ingatlah bahwa ada perbedaan waktu di wilayah yang menerapkan Waktu Musim Panas (atau Waktu Musim Panas), bergantung pada waktu dalam setahun.

values[]

string

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

periodMillis

string (int64 format)

Wajib diisi. Jumlah waktu validnya setiap kode batang.