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}: Wird durch den TOTP-Wert ersetzt (siehe TotpDetails.parameters). * {totp_timestamp_millis}: Wird durch den Zeitstempel (in Millisekunden seit der Epoche) ersetzt, zu dem der Barcode generiert wurde. * {totp_timestamp_seconds}: Wird durch den Zeitstempel (Sekunden seit der 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 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. Dies ist der Fall, wenn Smart-Bonus bei einer Karte bzw. einem 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 die Branche „Öffentliche Verkehrsmittel“ verfügbar. Optionale Anfangswerte für rotierende Barcodes. 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 Zeitintervall, das für die Generierung des TOTP-Werts verwendet wird, in Millisekunden.

algorithm

enum (TotpAlgorithm)

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

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 Wertelä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 Generierung des TOTP-Werts verwendet wird, codiert als Base16-String.

valueLength

integer

Die Länge des TOTP-Werts in Dezimalstellen.

RotatingBarcodeValues

Eine Payload mit vielen Barcodewerten und einem Startdatum/-zeitpunkt.

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

string

Erforderlich. Datum und Uhrzeit, ab dem bzw. der der erste Barcode gültig ist. Die Barcodes werden mit „periodMillis“, das in den RotatingBarcodeValueInfo des Objekts definiert ist, rotiert.

Datum/Uhrzeit im erweiterten ISO 8601-Format mit Offset. Die Uhrzeit kann bis auf die Nanosekunde genau angegeben werden. Offsets können bis auf die Sekunde genau angegeben werden (obwohl 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 obigen Beispiel). Falls die Veranstaltung in New York stattfindet, entspricht dies der Eastern Daylight Time (EDT). Beachten Sie, dass der Offset je nach Jahreszeit in Regionen mit Sommerzeit variiert.

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.