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 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

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 (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

object (TotpDetails)

Dettagli utilizzati per valutare le sostituzioni di {totp_value_n}.
alternateText

string

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

object (LocalizedString)

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

object (RotatingBarcodeValues)

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 (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 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

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

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 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:

1985-04-12T23:20:50.52Z corrisponderà a 20 minuti e 50, 52 secondi dopo la 23a ora del 12 aprile 1985 nel fuso orario UTC.

1985-04-12T19:20:50.52-04:00 corrisponde a 20 minuti e 50, 52 secondi dopo la 19 ora del 12 aprile 1985, 4 ore prima di UTC (lo stesso istante dell'esempio riportato sopra). Se l'evento si trovasse a New York, sarebbe l'ora legale della costa orientale (EDT). Ricorda che l'offset varia nelle regioni in cui è osservata l'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 validità di ciascun codice a barre.