การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ประเภทของบาร์โค้ดนี้ |
renderEncoding |
การเข้ารหัสการแสดงผลสำหรับบาร์โค้ด เมื่อระบุ บาร์โค้ดจะแสดงผลในการเข้ารหัสที่กำหนด ไม่เช่นนั้น Google จะเลือกการเข้ารหัสที่รู้จักมากที่สุด |
valuePattern |
ค่าบาร์โค้ดที่เข้ารหัสสตริง สตริงนี้รองรับการแทนที่ต่อไปนี้ * {totp_value_n}: แทนที่ด้วยค่า TOTP (ดู TotpDetails.parameters) * {totp_timestamp_millis}: แทนที่ด้วยการประทับเวลา (มิลลิวินาทีนับจาก Epoch) ที่สร้างบาร์โค้ดแล้ว * {totp_timestamp_seconds}: แทนที่ด้วยการประทับเวลา (วินาทีนับตั้งแต่ Epoch) ที่สร้างบาร์โค้ด |
totpDetails |
รายละเอียดที่ใช้ในการประเมินการแทน {totp_value_n} |
alternateText |
ข้อความที่ไม่บังคับซึ่งจะลบล้างข้อความเริ่มต้นที่แสดงใต้บาร์โค้ด ช่องนี้มีไว้เพื่อค่าที่มนุษย์อ่านได้ซึ่งเทียบเท่ากับค่าบาร์โค้ด ซึ่งใช้เมื่อสแกนบาร์โค้ดไม่ได้ |
showCodeText |
ข้อความเสริมที่จะปรากฏเมื่อบาร์โค้ดซ่อนอยู่หลังการคลิก กรณีนี้จะเกิดขึ้นในกรณีที่บัตรเปิดใช้การแตะอัจฉริยะ หากไม่ได้ระบุไว้ Google จะเลือกค่าเริ่มต้น |
initialRotatingBarcodeValues |
อินพุตเท่านั้น หมายเหตุ: ฟีเจอร์นี้ใช้ได้กับประเภทธุรกิจขนส่งสาธารณะเท่านั้น ชุดค่าบาร์โค้ดแบบหมุนเริ่มต้นที่ไม่บังคับ วิธีนี้จะช่วยให้ใส่บาร์โค้ดกับวัตถุได้บางส่วน ต้องอัปโหลดค่าบาร์โค้ดที่หมุนเวียนเพิ่มเติมด้วยปลายทาง UploadRotatingBarcodeValues |
TotpDetails
การกําหนดค่าสําหรับการแทน OTP ตามเวลา ดู https://tools.ietf.org/html/rfc6238
การแสดง JSON |
---|
{ "periodMillis": string, "algorithm": enum ( |
ช่อง | |
---|---|
periodMillis |
ช่วงเวลาที่ใช้สำหรับการสร้างค่า TOTP ในหน่วยมิลลิวินาที |
algorithm |
อัลกอริทึม TOTP ที่ใช้ในการสร้าง OTP |
parameters[] |
พารามิเตอร์ TOTP สำหรับการแทนค่า {totp_value_*} แต่ละรายการ ระบบใช้ TotpParameters ที่ดัชนี n สำหรับการแทน {totp_value_n} |
TotpAlgorithm
Enum | |
---|---|
TOTP_ALGORITHM_UNSPECIFIED |
|
TOTP_SHA1 |
อัลกอริทึม TOTP จาก RFC 6238 ที่มีฟังก์ชันแฮช SHA1 |
TotpParameters
การกำหนดค่าสำหรับความยาวของคีย์และค่า ดู https://www.rfc-editor.org/rfc/rfc4226#section-5.3
การแสดง JSON |
---|
{ "key": string, "valueLength": integer } |
ช่อง | |
---|---|
key |
คีย์ลับที่ใช้เพื่อสร้างค่า TOTP โดยเข้ารหัสเป็นสตริง Base16 |
valueLength |
ความยาวของค่า TOTP ในรูปแบบทศนิยม |
RotatingBarcodeValues
เพย์โหลดที่มีค่าบาร์โค้ดมากมายและวันที่/เวลาเริ่มต้น
การแสดง JSON |
---|
{ "startDateTime": string, "values": [ string ], "periodMillis": string } |
ช่อง | |
---|---|
startDateTime |
ต้องระบุ วันที่/เวลาที่บาร์โค้ดแรกถูกต้อง บาร์โค้ดจะหมุนเวียนผ่านการใช้ periodMillis ที่กำหนดไว้ใน RotatingBarcodeValueInfo ของออบเจ็กต์ วันที่/เวลาสำหรับรูปแบบแบบขยายของ ISO 8601 พร้อมออฟเซ็ต สามารถระบุเวลาได้แม่นยำถึงระดับนาโนวินาที คุณสามารถระบุออฟเซ็ตได้ด้วยความแม่นยําของวินาที (แม้ว่าออฟเซ็ตวินาทีจะไม่ใช่ส่วนหนึ่งของ ISO 8601) เช่น
|
values[] |
ต้องระบุ ค่าที่จะเข้ารหัสในบาร์โค้ด ต้องระบุอย่างน้อย 1 ค่า |
periodMillis |
ต้องระบุ ระยะเวลาที่ใช้ได้สำหรับบาร์โค้ดแต่ละรายการ |