RotatingBarcode

การแสดง JSON
{
  "type": enum (BarcodeType),
  "renderEncoding": enum (BarcodeRenderEncoding),
  "valuePattern": string,
  "totpDetails": {
    object (TotpDetails)
  },
  "alternateText": string,
  "showCodeText": {
    object (LocalizedString)
  },
  "initialRotatingBarcodeValues": {
    object (RotatingBarcodeValues)
  }
}
ช่อง
type

enum (BarcodeType)

ประเภทของบาร์โค้ดนี้

renderEncoding

enum (BarcodeRenderEncoding)

การเข้ารหัสการแสดงผลสำหรับบาร์โค้ด เมื่อระบุ บาร์โค้ดจะแสดงผลในการเข้ารหัสที่กำหนด ไม่เช่นนั้น Google จะเลือกการเข้ารหัสที่รู้จักมากที่สุด

valuePattern

string

ค่าบาร์โค้ดที่เข้ารหัสสตริง สตริงนี้รองรับการแทนที่ต่อไปนี้ * {totp_value_n}: แทนที่ด้วยค่า TOTP (ดู TotpDetails.parameters) * {totp_timestamp_millis}: แทนที่ด้วยการประทับเวลา (มิลลิวินาทีนับจาก Epoch) ที่สร้างบาร์โค้ดแล้ว * {totp_timestamp_seconds}: แทนที่ด้วยการประทับเวลา (วินาทีนับตั้งแต่ Epoch) ที่สร้างบาร์โค้ด

totpDetails

object (TotpDetails)

รายละเอียดที่ใช้ในการประเมินการแทน {totp_value_n}

alternateText

string

ข้อความที่ไม่บังคับซึ่งจะลบล้างข้อความเริ่มต้นที่แสดงใต้บาร์โค้ด ช่องนี้มีไว้เพื่อค่าที่มนุษย์อ่านได้ซึ่งเทียบเท่ากับค่าบาร์โค้ด ซึ่งใช้เมื่อสแกนบาร์โค้ดไม่ได้

showCodeText

object (LocalizedString)

ข้อความเสริมที่จะปรากฏเมื่อบาร์โค้ดซ่อนอยู่หลังการคลิก กรณีนี้จะเกิดขึ้นในกรณีที่บัตรเปิดใช้การแตะอัจฉริยะ หากไม่ได้ระบุไว้ Google จะเลือกค่าเริ่มต้น

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

อินพุตเท่านั้น หมายเหตุ: ฟีเจอร์นี้ใช้ได้กับประเภทธุรกิจขนส่งสาธารณะเท่านั้น ชุดค่าบาร์โค้ดแบบหมุนเริ่มต้นที่ไม่บังคับ วิธีนี้จะช่วยให้ใส่บาร์โค้ดกับวัตถุได้บางส่วน ต้องอัปโหลดค่าบาร์โค้ดที่หมุนเวียนเพิ่มเติมด้วยปลายทาง UploadRotatingBarcodeValues

TotpDetails

การกําหนดค่าสําหรับการแทน OTP ตามเวลา ดู https://tools.ietf.org/html/rfc6238

การแสดง JSON
{
  "periodMillis": string,
  "algorithm": enum (TotpAlgorithm),
  "parameters": [
    {
      object (TotpParameters)
    }
  ]
}
ช่อง
periodMillis

string (int64 format)

ช่วงเวลาที่ใช้สำหรับการสร้างค่า TOTP ในหน่วยมิลลิวินาที

algorithm

enum (TotpAlgorithm)

อัลกอริทึม TOTP ที่ใช้ในการสร้าง OTP

parameters[]

object (TotpParameters)

พารามิเตอร์ 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

string

คีย์ลับที่ใช้เพื่อสร้างค่า TOTP โดยเข้ารหัสเป็นสตริง Base16

valueLength

integer

ความยาวของค่า TOTP ในรูปแบบทศนิยม

RotatingBarcodeValues

เพย์โหลดที่มีค่าบาร์โค้ดมากมายและวันที่/เวลาเริ่มต้น

การแสดง JSON
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
ช่อง
startDateTime

string

ต้องระบุ วันที่/เวลาที่บาร์โค้ดแรกถูกต้อง บาร์โค้ดจะหมุนเวียนผ่านการใช้ periodMillis ที่กำหนดไว้ใน RotatingBarcodeValueInfo ของออบเจ็กต์

วันที่/เวลาสำหรับรูปแบบแบบขยายของ ISO 8601 พร้อมออฟเซ็ต สามารถระบุเวลาได้แม่นยำถึงระดับนาโนวินาที คุณสามารถระบุออฟเซ็ตได้ด้วยความแม่นยําของวินาที (แม้ว่าออฟเซ็ตวินาทีจะไม่ใช่ส่วนหนึ่งของ ISO 8601)

เช่น

1985-04-12T23:20:50.52Z จะเป็น 20 นาทีและ 50.52 วินาทีหลังจากชั่วโมงที่ 23 ของวันที่ 12 เมษายน 1985 ในเขตเวลา UTC

1985-04-12T19:20:50.52-04:00 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 และ 4 ชั่วโมงก่อนเวลา UTC (เป็นนาทีเดียวกับตัวอย่างด้านบน) หากเหตุการณ์เกิดขึ้นในนิวยอร์ก ค่านี้จะเทียบเท่ากับเวลาออมแสงตะวันออก (EDT) โปรดทราบว่าการชดเชยจะแตกต่างกันไปในภูมิภาคที่ใช้เวลาออมแสง (หรือเวลาในฤดูร้อน) โดยจะขึ้นอยู่กับช่วงเวลาของปี

values[]

string

ต้องระบุ ค่าที่จะเข้ารหัสในบาร์โค้ด ต้องระบุอย่างน้อย 1 ค่า

periodMillis

string (int64 format)

ต้องระบุ ระยะเวลาที่ใช้ได้สำหรับบาร์โค้ดแต่ละรายการ