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 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 in formato di 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 su una tessera sia attivato Smart Tap. Se non specificato, Google sceglie un valore predefinito.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Solo input. NOTA: questa funzionalità è disponibile solo per il verticale Trasporto pubblico. Set facoltativo di valori iniziali del codice a barre rotante. 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 utilizzato per la generazione del valore TOTP, in millisecondi.

algorithm

enum (TotpAlgorithm)

L'algoritmo TOTP utilizzato per generare l'OTP.

parameters[]

object (TotpParameters)

I parametri TOTP per ciascuna delle sostituzioni {totp_value_*}. I parametri TotpParameters all'indice n vengono utilizzati per la sostituzione {totp_value_n}.

TotpAlgorithm

Enum
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 Algoritmo TOTP del documento 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/ora a partire dalla quale è valido il primo codice a barre. I codici a barre verranno ruotati utilizzando periodMillis definito in RotatingBarcodeValueInfo dell'oggetto.

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

Ad esempio:

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

1985-04-12T19:20:50.52-04:00 corrisponde a 20 minuti e 50,52 secondi dopo la 19a ora del 12 aprile 1985, 4 ore prima del fuso orario UTC (stesso istante di tempo dell'esempio precedente). Se l'evento fosse a New York, sarebbe l'equivalente dell'ora legale 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. Il periodo di tempo di validità di ogni codice a barre.