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, 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á bằng 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 (tính bằng mili giây kể từ thời gian bắt đầu của hệ thống) tại thời điểm tạo mã vạch. * {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ùng để chứa giá trị tương đương của mã vạch mà con người có thể đọc được, được 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 tập hợp con nhỏ các 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 việc thay thế mã xác thực một lần (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 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 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ó giá trị bù trừ. Bạn có thể chỉ định thời gian với độ chính xác lên đến nano giây. Bạn có thể chỉ định độ lệch với độ chính xác đến giây (mặc dù độ lệch giây không thuộc tiêu chuẩn 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 nhập ít nhất một giá trị.

periodMillis

string (int64 format)

Bắt buộc. Khoảng thời gian mỗi mã vạch hợp lệ.