RotatingBarcode

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

enum (BarcodeType)

Il tipo di questo codice a barre.
renderEncoding

enum (BarcodeRenderEncoding)

La codifica di rendering per il codice a barre. Se specificato, il codice a barre viene visualizzato nella codifica specificata. Altrimenti, la codifica più nota viene scelta da Google.
valuePattern

string

Valore del codice a barre codificato nella stringa. Questa stringa supporta le seguenti sostituzioni: * {totp_value_n}: sostituito con il valore TOTP (vedi TotpDetails.parameters). * {totp_timestamp_millis}: sostituito con il timestamp (millisecondi dall'epoca) in cui è stato generato il codice a barre. * {totp_timestamp_seconds}: sostituito con il timestamp (secondi dall'epoca) in cui è stato generato il codice a barre.
totpDetails

object (TotpDetails)

Dettagli utilizzati per valutare le sostituzioni {totp_value_n}.
alternateText

string

Un testo facoltativo che sostituirà il testo predefinito visualizzato sotto il codice a barre. Questo campo è destinato a un equivalente leggibile del valore del codice a barre, utilizzato quando non è possibile scansionare il codice a barre.
showCodeText

object (LocalizedString)

Testo facoltativo che verrà visualizzato quando il codice a barre è nascosto da un'azione di clic. Questo accade nei casi in cui per una tessera è attivo Smart Tap. Se non specificato, Google sceglie un valore predefinito.
initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Solo input. NOTA: questa funzionalità è disponibile solo per il verticale di Google Transit. Insieme facoltativo di valori di codici a barre a rotazione iniziali. Ciò consente di includere nell'oggetto un piccolo sottoinsieme di codici a barre. È necessario caricare ulteriori valori di codici a barre a rotazione con l'endpoint UploadRotatingBarcodeValues.

TotpDetails

Configurazione per le sostituzioni OTP basate sull'ora. Consulta la pagina https://tools.ietf.org/html/rfc6238

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

string (int64 format)

L'intervallo di tempo in millisecondi utilizzato per la generazione del valore TOTP.
algorithm

enum (TotpAlgorithm)

L'algoritmo TOTP utilizzato per generare l'OTP.
parameters[]

object (TotpParameters)

I parametri TOTP per ciascuna delle sostituzioni {totp_value_*}. TotpParameters nell'indice n viene utilizzato per la sostituzione {totp_value_n}.

TotpAlgorithm

Enum
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 Algoritmo TOTP da RFC 6238 con la funzione hash SHA1

TotpParameters

Configurazione della lunghezza della chiave e del valore. Consulta la pagina https://www.rfc-editor.org/rfc/rfc4226#section-5.3

Rappresentazione JSON 
{
  "key": string,
  "valueLength": integer
}
Campi
key

string

La chiave segreta utilizzata per la generazione del valore TOTP, codificata come stringa Base16.
valueLength

integer

La lunghezza del valore TOTP in cifre decimali.

RotatingBarcodeValues

Un payload contenente molti valori di codici a barre e data/ora di inizio.

Rappresentazione JSON 
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
Campi
startDateTime

string

Obbligatorio. La data e l'ora da cui è valido il primo codice a barre. I codici a barre verranno ruotati utilizzando periodMillis definito nella sezione RotatingBarcodeValueInfo dell'oggetto.

Data/ora nel formato esteso ISO 8601 con offset. Il tempo può essere specificato con una precisione fino a nanosecondi. Gli offset possono essere specificati con la precisione in secondi (anche se i secondi di offset non fanno parte di ISO 8601).

Ad esempio:

1985-04-12T23:20:50.52Z sarebbe 20 minuti e 50, 52 secondi dopo la 23a ora del 12 aprile 1985 in UTC.

1985-04-12T19:20:50.52-04:00 corrisponderebbe a 20 minuti e 50, 52 secondi dopo la 19a ora del 12 aprile 1985, 4 ore prima del fuso orario UTC (stesso istante dell'esempio riportato sopra). Se l'evento si verificasse a New York, equivale all'ora legale della costa orientale (EDT). Ricorda che l'offset varia nelle regioni che osservano l'ora legale (o ora legale), a seconda del periodo dell'anno.
values[]

string

Obbligatorio. I valori da codificare nel codice a barre. Almeno un valore è obbligatorio.
periodMillis

string (int64 format)

Obbligatorio. La quantità di tempo di validità di ciascun codice a barre.