RotatingBarcode

Biểu diễn dưới dạng JSON
{
  "type": enum (BarcodeType),
  "renderEncoding": enum (BarcodeRenderEncoding),
  "valuePattern": string,
  "totpDetails": {
    object (TotpDetails)
  },
  "alternateText": string,
  "showCodeText": {
    object (LocalizedString)
  },
  "initialRotatingBarcodeValues": {
    object (RotatingBarcodeValues)
  }
}
Trường
type

enum (BarcodeType)

Loại mã vạch này.

renderEncoding

enum (BarcodeRenderEncoding)

Mã hoá kết xuất cho mã vạch. Khi được chỉ định, mã vạch sẽ được hiển thị theo mã hoá đã cho. Nếu không, Google sẽ chọn phương thức mã hoá phổ biến nhất.

valuePattern

string

Giá trị mã vạch được mã hoá theo chuỗi. Chuỗi này hỗ trợ các nội dung thay thế sau: * {totp_value_n}: Được thay thế bằng giá trị TOTP (xem TotpDetails.parameters). * {totp_timestamp_millis}: Được thay thế bằng dấu thời gian (mili giây kể từ thời gian bắt đầu của hệ thống) mà mã vạch được tạo. * {totp_timestamp_seconds}: Được thay thế bằng dấu thời gian (giây kể từ thời gian bắt đầu) tại thời điểm tạo mã vạch.

totpDetails

object (TotpDetails)

Thông tin chi tiết dùng để đánh giá các giá trị thay thế {totp_value_n}.

alternateText

string

Văn bản không bắt buộc sẽ ghi đè văn bản mặc định xuất hiện bên dưới mã vạch. Trường này dành cho giá trị mã vạch tương đương với giá trị mã vạch mà con người có thể đọc được, được sử dụng khi không thể quét mã vạch.

showCodeText

object (LocalizedString)

Văn bản không bắt buộc sẽ xuất hiện khi mã vạch bị ẩn sau một hành động nhấp. Điều này xảy ra trong trường hợp thẻ và vé đã bật tính năng Chạm thông minh. Nếu bạn không chỉ định, Google sẽ chọn một giá trị mặc định.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Chỉ nhập. LƯU Ý: Tính năng này chỉ dành cho ngành dọc về phương tiện công cộng. Tập hợp các giá trị mã vạch xoay ban đầu (không bắt buộc). Điều này cho phép đưa một nhóm nhỏ mã vạch vào đối tượng. Bạn phải tải các giá trị mã vạch xoay vòng khác lên bằng điểm cuối UploadRotatingBarcodeValues.

TotpDetails

Cấu hình cho các yêu cầu thay thế OTP dựa trên thời gian. Hãy xem https://tools.ietf.org/html/rfc6238

Biểu diễn dưới dạng JSON
{
  "periodMillis": string,
  "algorithm": enum (TotpAlgorithm),
  "parameters": [
    {
      object (TotpParameters)
    }
  ]
}
Trường
periodMillis

string (int64 format)

Khoảng thời gian dùng để tạo giá trị TOTP, tính bằng mili giây.

algorithm

enum (TotpAlgorithm)

Thuật toán TOTP dùng để tạo OTP.

parameters[]

object (TotpParameters)

Các tham số TOTP cho mỗi lần thay thế {totp_value_*}. TotpParameters tại chỉ mục n được dùng để thay thế {totp_value_n}.

TotpAlgorithm

Enum
TOTP_ALGORITHM_UNSPECIFIED
TOTP_SHA1 Thuật toán TOTP theo RFC 6238 với hàm băm SHA1

TotpParameters

Cấu hình cho độ dài khoá và giá trị. Xem https://www.rfc-editor.org/rfc/rfc4226#section-5.3

Biểu diễn dưới dạng JSON
{
  "key": string,
  "valueLength": integer
}
Trường
key

string

Khoá bí mật dùng để tạo giá trị TOTP, được mã hoá dưới dạng chuỗi Base16.

valueLength

integer

Độ dài của giá trị TOTP theo chữ số thập phân.

RotatingBarcodeValues

Gói dữ liệu chứa nhiều giá trị mã vạch và ngày/giờ bắt đầu.

Biểu diễn dưới dạng JSON
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
Trường
startDateTime

string

Bắt buộc. Ngày/giờ mà mã vạch đầu tiên có hiệu lực. Mã vạch sẽ được xoay bằng cách sử dụng periodMillis được xác định trên RotatingBarcodeValueInfo của đối tượng.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601, có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác lên đến nano giây. Có thể chỉ định giá trị chênh lệch với độ chính xác theo giây (mặc dù giây bù trừ không phải là một phần của ISO 8601).

Ví dụ:

1985-04-12T23:20:50.52Z sẽ là 20 phút và 50,52 giây sau 23 giờ ngày 12 tháng 4 năm 1985 theo giờ UTC.

1985-04-12T19:20:50.52-04:00 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985, tức là 4 giờ trước giờ UTC (cùng thời điểm với ví dụ trên). Nếu sự kiện diễn ra ở New York, thì múi giờ này sẽ tương đương với Giờ ban ngày miền Đông (EDT). Hãy nhớ rằng độ lệch thay đổi tuỳ theo thời gian trong năm ở những khu vực áp dụng Giờ mùa hè (hay Giờ mùa hè).

values[]

string

Bắt buộc. Các giá trị cần mã hoá trong mã vạch. Bạn phải cung cấp ít nhất một giá trị.

periodMillis

string (int64 format)

Bắt buộc. Khoảng thời gian có hiệu lực của mỗi mã vạch.