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 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. 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 zum Bewerten der {totp_value_n}-Substitutionen.

alternateText

string

Optionaler Text, der den Standardtext überschreibt, der unter dem Barcode angezeigt wird. Dieses Feld ist zur Angabe einer von Menschen lesbaren 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 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. So kann ein kleiner Teil der Barcodes mit dem Objekt verknüpft 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 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 mit 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

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

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

string

Erforderlich. Datum/Uhrzeit des Gültigkeitsbeginns für den ersten Barcode. Die Barcodes werden mit „periodMillis“, das in den RotatingBarcodeValueInfo des Objekts definiert ist, 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, 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 obigen Beispiel). Würde der Termin in New York stattfinden, wäre dies die Entsprechung in 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 jedes Barcodes.