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)

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