RotatingBarcode

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

enum (BarcodeType)

Die Art dieses Barcodes.

renderEncoding

enum (BarcodeRenderEncoding)

Die Codierung zum Rendern des Barcodes. Wenn angegeben, wird der Barcode in dieser Codierung gerendert. Andernfalls wird von Google die bekannteste Codierung ausgewählt.

valuePattern

string

Stringcodierter Barcodewert. Diese Zeichenfolge unterstützt die folgenden Substitutionen: * {totp_value_n}: Wird durch den TOTP-Wert ersetzt (siehe TotpDetails.parameters). * {totp_timestamp_millis}: Durch den Zeitstempel (Millisekunden seit Epoche) ersetzt, zu dem der Barcode generiert wurde. * {totp_timestamp_seconds}: Durch den Zeitstempel (Sekunden seit Epoche) ersetzt, zu dem der Barcode generiert wurde.

totpDetails

object (TotpDetails)

Details zur Auswertung der {totp_value_n}-Substitutionen.

alternateText

string

Optionaler Text, der den Standardtext überschreibt, der unter dem Barcode angezeigt wird. Dieses Feld ist für eine von Menschen lesbare Entsprechung des Barcodewerts vorgesehen, wenn der Barcode nicht gescannt werden kann.

showCodeText

object (LocalizedString)

Optionaler Text, der angezeigt wird, wenn der Barcode hinter einer Klickaktion verborgen ist. Dies ist der Fall, wenn Smart-Bonus für Karten/Tickets aktiviert ist. Wenn keine Angabe erfolgt, wird von Google ein Standardwert ausgewählt.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Nur Eingabe. HINWEIS: Diese Funktion ist nur für öffentliche Verkehrsmittel verfügbar. Optionaler Satz von anfänglichen rotierenden Barcodewerten. Dadurch kann eine kleine Teilmenge von Barcodes zum Objekt hinzugefügt werden. Weitere rotierende Barcodewerte müssen mit dem Endpunkt UploadRotatingBarcodeValues hochgeladen werden.

TotpDetails

Konfiguration für die zeitbasierten OTP-Ersetzungen. Weitere Informationen finden Sie unter https://tools.ietf.org/html/rfc6238.

JSON-Darstellung
{
  "periodMillis": string,
  "algorithm": enum (TotpAlgorithm),
  "parameters": [
    {
      object (TotpParameters)
    }
  ]
}
Felder
periodMillis

string (int64 format)

Das für die TOTP-Werterzeugung verwendete Zeitintervall in Millisekunden.

algorithm

enum (TotpAlgorithm)

Der TOTP-Algorithmus, der zum Generieren des OTP verwendet wird.

parameters[]

object (TotpParameters)

Die TOTP-Parameter für jede {totp_value_*}-Ersetzung. Die TotpParameters bei Index n wird für die {totp_value_n}-Substitution verwendet.

TotpAlgorithm

Enums
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 TOTP-Algorithmus von RFC 6238 mit der SHA1-Hash-Funktion

TotpParameters

Konfiguration für die Schlüssel- und Wertlänge. Weitere Informationen finden Sie unter https://www.rfc-editor.org/rfc/rfc4226#section-5.3

JSON-Darstellung
{
  "key": string,
  "valueLength": integer
}
Felder
key

string

Der geheime Schlüssel, der für die TOTP-Wertgenerierung verwendet wird und als Base16-String codiert ist.

valueLength

integer

Die Länge des TOTP-Werts in Dezimalzahlen.

RotatingBarcodeValues

Nutzlast, die viele Barcodewerte und Startdatum/-zeit enthält.

JSON-Darstellung
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
Felder
startDateTime

string

Erforderlich. Datum und Uhrzeit der Gültigkeit des ersten Barcodes Barcodes werden mithilfe von periodMillis, die in den RotatingBarcodeValueInfo des Objekts definiert sind, rotiert.

Datum/Uhrzeit im erweiterten ISO 8601-Format mit Offset. Die Zeit kann bis auf die Nanosekunde genau angegeben werden. Offsets können sekundengenau angegeben werden (obwohl Offset-Sekunden nicht Teil von ISO 8601 sind).

Beispiel:

1985-04-12T23:20:50.52Z entspricht 20 Minuten und 50, 52 Sekunden nach der 23. Stunde am 12. April 1985 in UTC.

1985-04-12T19:20:50.52-04:00 entspricht 20 Minuten und 50, 52 Sekunden nach der 19. Stunde am 12. April 1985, 4 Stunden vor UTC (gleicher Zeitpunkt wie im obigen Beispiel). In New York entspräche dies der Eastern Daylight Time (EDT). Der Offset variiert je nach Jahreszeit in Regionen, in denen die Sommerzeit gilt.

values[]

string

Erforderlich. Die zu codierenden Werte im Barcode. Es ist mindestens ein Wert erforderlich.

periodMillis

string (int64 format)

Erforderlich. Die Gültigkeitsdauer jedes Barcodes.