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á hiển thị cho mã vạch. Khi được chỉ định, mã vạch sẽ hiển thị theo phương thức mã hoá đã cho. Nếu không, phương thức mã hoá phổ biến nhất sẽ do Google chọn.

valuePattern

string

Giá trị mã vạch được mã hoá theo chuỗi. Chuỗi này hỗ trợ các 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 epoch) mà mã vạch được tạo.

totpDetails

object (TotpDetails)

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

alternateText

string

Một văn bản không bắt buộc sẽ thay thế văn bản mặc định xuất hiện bên dưới mã vạch. Đây là trường 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 thao tác nhấp. Điều này xảy ra trong trường hợp thẻ/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ỉ có sẵn cho ngành dọc phương tiện công cộng. Bộ 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)

Tham số TOTP cho mỗi lần thay thế {totp_value_*}. TotpParameters ở chỉ mục n được sử dụng để thay thế {totp_value_n}.

TotpAlgorithm

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

TotpParameters

Cấu hình cho độ dài khoá và giá trị. Hãy 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 bằng chữ số thập phân.

RotatingBarcodeValues

Tải trọng 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ã vạch đầu tiên có hiệu lực. Mã vạch sẽ được xoay qua bằng cách sử dụng phần giảm giá trị (periodMillis) được xác định trên thuộc tính RotatingBarcodeValueInfo của đối tượng.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601, có giá trị bù trừ. Thời gian có thể được chỉ định 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 50, 52 giây sau giờ thứ 23 của 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 50, 52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985, 4 giờ trước giờ UTC (cùng thời gian như ví dụ trên). Nếu sự kiện diễn ra ở New York, thì thời gian này sẽ tương đương với Giờ ban ngày miền Đông (EDT). Xin lưu ý rằng mức chênh lệch sẽ khác nhau tuỳ theo khu vực áp dụng Giờ tiết kiệm ánh sáng ngày (hay Giờ mùa hè), tuỳ thuộc vào thời gian trong năm.

values[]

string

Bắt buộc. Các giá trị cần mã hoá trong mã vạch. Bạn phải nhậ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.