Rappresentazione JSON |
---|
{ "type": enum ( |
Campi | |
---|---|
type |
Il tipo di questo codice a barre. |
renderEncoding |
La codifica di rendering del codice a barre. Se specificato, il codice a barre viene visualizzato nella codifica specificata. In caso contrario, la codifica più nota viene scelta da Google. |
valuePattern |
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 (in 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 |
Dettagli utilizzati per valutare le sostituzioni di {totp_value_n}. |
alternateText |
Un testo facoltativo che sostituisce 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 |
Testo facoltativo che verrà mostrato quando il codice a barre è nascosto dietro un'azione di clic. Questo accade nei casi in cui la tessera Smart Tap è attiva. Se non specificato, Google sceglie un valore predefinito. |
initialRotatingBarcodeValues |
Solo input. NOTA: questa funzionalità è disponibile solo per il verticale trasporto pubblico. Insieme facoltativo di valori del codice a barre rotanti iniziali. Ciò consente di includere nell'oggetto un piccolo sottoinsieme di codici a barre. Gli ulteriori valori dei codici a barre a rotazione devono essere caricati con l'endpoint UploadRotatingBarcodeValues. |
TotpDetails
Configurazione per le sostituzioni OTP basate sul tempo. Vedi https://tools.ietf.org/html/rfc6238
Rappresentazione JSON |
---|
{ "periodMillis": string, "algorithm": enum ( |
Campi | |
---|---|
periodMillis |
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 di {totp_value_*}. Il parametro TotpParameters all'indice n viene utilizzato per la sostituzione di {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. Vedi 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. |
valueLength |
La lunghezza del valore TOTP in cifre decimali. |
RotatingBarcodeValues
Payload contenente molti valori di codici a barre e data/ora di inizio.
Rappresentazione JSON |
---|
{ "startDateTime": string, "values": [ string ], "periodMillis": string } |
Campi | |
---|---|
startDateTime |
obbligatorio. La data e l'ora dal quale è valido il primo codice a barre. I codici a barre verranno ruotati utilizzando il parametro periodMillis definito nel valore RotatingBarcodeValueInfo dell'oggetto. Si tratta di un formato di data e ora in formato ISO 8601 esteso, con un offset. Il tempo può essere specificato con una precisione fino a un nanosecondo. Gli offset possono essere specificati con precisione in secondi (anche se l'offset in secondi non fa parte di ISO 8601). Ad esempio:
|
values[] |
obbligatorio. I valori da codificare nel codice a barre. Almeno un valore è obbligatorio. |
periodMillis |
obbligatorio. Il periodo di validità di ciascun codice a barre. |