Rappresentazione JSON |
---|
{ "type": enum ( |
Campi | |
---|---|
type |
Il tipo di codice a barre. |
render |
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. |
value |
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. |
totp |
Dettagli utilizzati per valutare le sostituzioni {totp_value_n}. |
alternate |
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. |
show |
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. |
initial |
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 ( |
Campi | |
---|---|
period |
L'intervallo di tempo utilizzato per la generazione del valore TOTP, in millisecondi. |
algorithm |
L'algoritmo TOTP utilizzato per generare l'OTP. |
parameters[] |
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 |
La chiave segreta utilizzata per la generazione del valore TOTP, codificata come stringa Base16. |
value |
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 | |
---|---|
start |
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:
|
values[] |
Obbligatorio. I valori da codificare nel codice a barre. Almeno un valore è obbligatorio. |
period |
Obbligatorio. Il periodo di tempo di validità di ogni codice a barre. |