Trang này được dịch bởi Cloud Translation API.

Thẻ và vé được liên kết tự động

Thông tin khái quát

Tính năng Thẻ và vé được tự động liên kết cho phép bạn gửi thêm thẻ và vé đến một khi họ đã có thẻ và vé trong Google Wallet của họ. Bạn cũng có thể đường liên kết trước sẽ chuyển đến lượt truyền chính khi người dùng lưu phương thức thanh toán chính (chính). Thẻ và vé được liên kết tự động được nhóm với thẻ và vé chính có chú thích phía trên thẻ/vé chính để cho người dùng biết rằng thẻ/vé mới đã được được liên kết. Các loại thẻ và vé sau đây được hỗ trợ làm thẻ và vé chính hoặc thẻ và vé được liên kết;

Vé sự kiện
Thẻ lên máy bay
Thẻ đi phương tiện công cộng
Lời đề nghị
Thẻ quà tặng
Thẻ khách hàng thân thiết
Thẻ và vé chung


Thẻ/vé chính kèm theo chú thích cho biết một thẻ/vé mới đã được thêm	Thẻ/vé mới được liên kết với thẻ/vé chính

Trường hợp sử dụng

Bạn có thể có nhiều trường hợp sử dụng để liên kết thẻ và vé với một thẻ và vé hiện có. Hơi nhiều ví dụ bao gồm:

Liên kết ưu đãi với thẻ khách hàng thân thiết hiện có.
Liên kết phiếu ăn với thẻ lên máy bay hoặc vé xem sự kiện.
Liên kết vé đỗ xe với vé xem sự kiện.

Một số điều cần cân nhắc khi sử dụng Thẻ và vé được liên kết tự động

Đối tượng chính và đối tượng được liên kết phải sử dụng cùng một phát hành mã.
Mỗi đối tượng chính chỉ được có tối đa 50 đối tượng liên kết.
Việc tự động đẩy các thẻ và vé được liên kết sẽ không được đảm bảo và sẽ được xem xét nỗ lực tốt nhất. Người dùng có thể chọn không nhận Thẻ và vé được liên kết tự động. Nếu trường hợp sử dụng là quan trọng và người dùng phải nhận được thẻ và vé được liên kết, thì bạn nên giao tiếp thông qua một kênh khác để đảm bảo người dùng thêm thẻ và vé.
Thông tin cập nhật về Chính sách sử dụng (AUP) của Google Wallet có hướng dẫn về cách sử dụng Thẻ và vé được liên kết tự động mà bạn phải tuân thủ.

Các bước tích hợp

Nếu đã tạo đối tượng chính, bạn có thể bỏ qua bước 1.

Tạo một đối tượng của bất kỳ loại thẻ/vé nào được liệt kê bằng các tham số bắt buộc. Đây là đối tượng chính.
Tạo một đối tượng khác thuộc bất kỳ loại thẻ/vé nào được liệt kê. Đây sẽ là được liên kết.
Trước hoặc sau khi lưu đối tượng chính, hãy cập nhật đối tượng chính có mã nhận dạng của đối tượng được liên kết trong linkedObjectIds .

Cần có tải trọng tối thiểu để đặt linkedObjectIds trên . 3 thông số bắt buộc bao gồm:

ISSUERID.PRIMARY_OBJECT_ID
ISSUERID.PRIMARY_CLASS_ID
ISSUERID.LINKED_OBJECT_ID

Ví dụ về Yêu cầu JSON để thêm một đối tượng được liên kết vào một đối tượng truyền

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

Ví dụ về Phản hồi JSON sau khi liên kết một đối tượng với một đối tượng truyền

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Hành vi dự kiến

Sau khi nhận được phản hồi thành công, thiết bị có thẻ và vé mà bạn đã cập nhật sẽ nhận được thẻ/vé được liên kết. Thẻ/vé đã liên kết này sẽ được nhóm lại với nhau với thẻ và vé chính. Người dùng có thể xem thẻ/vé được liên kết bằng cách vuốt sang phải.

Xử lý ngoại lệ

Các lỗi có thể xảy ra khi sử dụng API không đúng cách. Điều này có thể bao gồm;

Tin nhắn	Lý do
Đối tượng chính và đối tượng được liên kết không thuộc cùng một đối tượng phát hành Mã nhận dạng.	Bạn không thể đính kèm một đối tượng liên kết vào đối tượng của một nhà phát hành khác.
Đối tượng chính và đối tượng được liên kết tham chiếu đến cùng một đối tượng.	Bạn không thể đính kèm cùng một đối tượng với linkedObject.
Đối tượng được liên kết không tồn tại.	Đối tượng được liên kết phải được chèn sẵn vào Wallet API.
Đối tượng được liên kết đã có một đối tượng được liên kết khác. Không thể thêm các mục lồng nhau đối tượng được liên kết.	Đối tượng liên kết không được có một đối tượng liên kết khác.
Đối tượng đã được liên kết với một đối tượng khác. Không thể thêm đường liên kết lồng ghép .	Đối tượng chính không được là một đối tượng được liên kết.
Không thể thêm bất kỳ đối tượng liên kết nào nữa, đã vượt quá giới hạn.	Đã đạt đến giới hạn 50 thẻ và vé được liên kết cho gói thuê bao chính .