JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type |
Der Typ dieses Barcodes. |
render |
Die Renderingcodierung für den Barcode. Wenn angegeben, wird der Barcode in dieser Codierung gerendert. Andernfalls wird von Google die bekannteste Codierung ausgewählt. |
value |
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. |
totp |
Details zur Auswertung der {totp_value_n}-Substitutionen. |
alternate |
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. |
show |
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. |
initial |
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 ( |
Felder | |
---|---|
period |
Das Zeitintervall, das für die Generierung des TOTP-Werts verwendet wird, in Millisekunden. |
algorithm |
Der TOTP-Algorithmus, der zum Generieren des OTP verwendet wird. |
parameters[] |
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 |
Der geheime Schlüssel, der für die Generierung des TOTP-Werts verwendet wird, codiert als Base16-String. |
value |
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 | |
---|---|
start |
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:
|
values[] |
Erforderlich. Die Werte, die im Barcode codiert werden sollen. Es ist mindestens ein Wert erforderlich. |
period |
Erforderlich. Die Gültigkeitsdauer der einzelnen Barcodes. |