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 พร้อมออฟเซ็ต คุณสามารถระบุเวลาได้สูงสุด 1 นนาโนวินาที คุณสามารถระบุค่าชดเชยด้วยความแม่นยำของวินาที (แม้ว่าวินาทีออฟเซ็ตจะไม่ได้เป็นส่วนหนึ่งของ ISO 8601 ก็ตาม)

เช่น

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

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

values[]

string

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

periodMillis

string (int64 format)

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