Tổng quan

API Thẻ và vé trong Google Wallet giúp đối tác tiết kiệm chi phí Xoay Mã vạch vào Google Wallet. Những mã vạch này chỉ hợp lệ trong một khoảng thời gian ngắn, tăng cường bảo mật để giảm nguy cơ chụp ảnh màn hình mã vạch. Chiến lược phát hành đĩa đơn Mã vạch được tạo trên thiết bị theo RFC 6238, cùng với đối tác cung cấp khoá bí mật. Tuy nhiên, nếu đối tác muốn tự tạo mã vạch, Google sẽ cung cấp API để có thể tải hàng loạt mã vạch lên Google. Sau đó, những mã vạch này sẽ được truyền đến bộ nhớ đệm của người dùng điện thoại di động, nơi chúng sẽ hoạt động giống như Xoay mã vạch, hiển thị trong một khoảng thời gian ngắn. Chúng tôi gọi giải pháp này là do đối tác tạo Xoay mã vạch.

API mã vạch xoay do đối tác tạo

Mã vạch xoay do đối tác tạo được tạo bằng cùng một mã vạch xoay . Chỉ cần loại dữ liệu, mặc dù chúng tôi cũng khuyên bạn nên tạo một điều kiện khởi động nhỏ bộ mã vạch trị giá (~10 phút) và gửi mã initialRotatingBarcodeValues. Đối tác chịu trách nhiệm đảm bảo rằng có luôn có mã vạch hợp lệ cho người dùng và initialRotatingBarcodeValues cho phép lệnh gọi tải lên hàng loạt tiếp theo thành không đồng bộ.

  rotatingBarcode {
    initialRotatingBarcodeValues: object (RotatingBarcodeValues),
    type: enum (BarcodeType),
  }
Trường Mô tả
initialRotatingBarcodeValues

object (RotatingBarcodeValues)

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ị. Tên viết tắt này mã vạch giúp thu hẹp khoảng cách giữa thời điểm người dùng nhận thẻ và vé lần đầu tiên khi lệnh gọi tải lên hàng loạt tiếp theo được thực hiện.
type

enum (BarcodeType)

Bắt buộc. Loại mã vạch này.

Các giá trị được chấp nhận là:

  • QR_CODE
  • PDF_417
RotatingBarcodeValues
Trường Mô tả
startDateTime

string

Ngày/giờ mã vạch đầu tiên có hiệu lực. Mã vạch sẽ được xoay qua đang sử dụng periodMillis.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601, có giá trị bù trừ.
values[]

string

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ị.

Không có số lượng giá trị tối đa, nhưng hãy lưu ý rằng kích thước của phần nội dung yêu cầu không được vượt quá 5MB.
periodMillis

number

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

Cập nhật hàng loạt giá trị mã vạch

Sau khi tạo đối tượng Xoay mã vạch, chúng tôi khuyên bạn nên tải mã vạch mỗi ngày cho đến khi thẻ/vé của người dùng hết hạn. Bạn có thể thực hiện việc này bằng theo điểm cuối của API REST.

Phương thức: Transitobject.uploadrotatingbarcodevalues

Tải các giá trị mã vạch xoay vòng lên đối tượng chuyển tuyến được tham chiếu theo mã đối tượng đã cho.

Yêu cầu HTTP

POST https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc eId}/uploadRotatingBarcodeValues

Tham số đường dẫn

Thông số Mô tả
resourceId

string

Giá trị nhận dạng duy nhất của một đối tượng.

Nội dung yêu cầu

Nội dung yêu cầu (không được vượt quá 5MB) chứa một bản sao của RotatingBarcodeValues.

Phương thức: Transitobject.downloadrotatingbarcodevalues

Tải các giá trị mã vạch xoay vòng xuống cho đối tượng phương tiện công cộng được tham chiếu theo đối tượng đã cho Mã nhận dạng. Cách này sẽ hữu ích nếu đối tác muốn xác minh lô mới nhất.

Yêu cầu HTTP

GET https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do wnloadRotatingBarcodeValues?alt=media

Tham số đường dẫn

Thông số Mô tả
resourceId

string

Giá trị nhận dạng duy nhất của một đối tượng.

Cơ chế dự phòng

Lưu ý rằng nếu Mã vạch xoay hợp lệ khác không có mã vạch hợp lệ để hiển thị (mã vạch này chưa được tải lên hoặc tất cả mã vạch hiện tại đã được sử dụng), lỗi thông báo sẽ được hiển thị cho người dùng.