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)

Der Typ dieses Barcodes.

renderEncoding

enum (BarcodeRenderEncoding)

Die Renderingcodierung für den Barcode. Wenn angegeben, wird der Barcode in dieser Codierung gerendert. Andernfalls wird von Google die bekannteste Codierung ausgewählt.

valuePattern

string

Als String codierter Barcodewert. Dieser String unterstützt die folgenden Ersetzungen: * {totp_value_n}: Ersetzt durch den TOTP-Wert (siehe TotpDetails.parameters). * {totp_timestamp_millis}: Wird durch den Zeitstempel (Millisekunden seit Epoche) ersetzt, zu dem der Barcode generiert wurde. * {totp_timestamp_seconds}: Wird durch den Zeitstempel (Sekunden seit Epoche) ersetzt, zu dem der Barcode generiert wurde.

totpDetails

object (TotpDetails)

Details zum Bewerten der {totp_value_n}-Substitutionen.

alternateText

string

Ein optionaler Text, der den Standardtext überschreibt, der unter dem Barcode angezeigt wird. Dieses Feld ist für ein menschenlesbares Äquivalent zum Barcodewert vorgesehen, das verwendet wird, wenn der Barcode nicht gescannt werden kann.

showCodeText

object (LocalizedString)

Optionaler Text, der angezeigt wird, wenn der Barcode hinter einer Klickaktion verborgen ist. Das ist der Fall, wenn Smart-Bonus für eine Karte bzw. ein Ticket aktiviert ist. Wenn nicht angegeben, 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 anfänglicher rotierender Barcodewerte. Dadurch kann eine kleine Teilmenge von Barcodes in das Objekt aufgenommen werden. Weitere rotierende Barcodewerte müssen mit dem UploadRotatingBarcodeValues-Endpunkt 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-Wertgenerierung verwendete Zeitintervall in Millisekunden.

algorithm

enum (TotpAlgorithm)

Der TOTP-Algorithmus, mit dem das OTP generiert wurde.

parameters[]

object (TotpParameters)

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

TotpAlgorithm

Enums
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 TOTP-Algorithmus aus 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 für die TOTP-Wertgenerierung verwendete geheime Schlüssel, codiert als Base16-String.

valueLength

integer

Die Länge des TOTP-Werts in Dezimalstellen.

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 ab dem der erste Barcode gültig ist. Barcodes werden mithilfe von periodMillis rotiert, der auf RotatingBarcodeValueInfo des Objekts definiert ist.

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, auch wenn Offset-Sekunden nicht in ISO 8601 enthalten 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 Beispiel oben). Würde der Termin in New York stattfinden, wäre dies die Entsprechung in Eastern Daylight Time (EDT). Der Offset variiert je nach Jahreszeit in Regionen, in denen Sommerzeit gilt.

values[]

string

Erforderlich. Die Werte, die im Barcode codiert werden sollen. Es ist mindestens ein Wert erforderlich.

periodMillis

string (int64 format)

Erforderlich. Die Gültigkeitsdauer der einzelnen Barcodes.