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

Thông tin khái quát

Tính năng Tự động liên kết thẻ và vé cho phép bạn gửi thêm thẻ và vé cho người dùng đã có thẻ và vé hiện tại của bạn trong Google Wallet. Bạn cũng có thể liên kết trước thẻ và vé với thẻ chính khi người dùng lưu thẻ chính (thẻ chính). Thẻ được liên kết tự động sẽ được nhóm với thẻ chính, có chú thích phía trên thẻ chính để thông báo cho người dùng rằng một thẻ mới đã được liên kết. Các loại thẻ và vé sau đây được hỗ trợ dưới dạng 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
• Ưu đãi
• Thẻ quà tặng
• Thẻ khách hàng thân thiết
• Thẻ và vé chung

Thẻ và vé chính có chú thích cho biết thẻ và vé mới đã được thêm	Thẻ và vé mới được liên kết với thẻ và 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ó. Sau đây là một số ví dụ:

• Liên kết một ưu đãi với thẻ khách hàng thân thiết hiện có.
• Liên kết phiếu mua đồ ăn với thẻ lên máy bay hoặc vé xem sự kiện.
• Liên kết thẻ đỗ xe với vé 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 issuerId.
• Mỗi đối tượng chính chỉ được có tối đa 50 đối tượng được liên kết.
• Việc tự động đẩy thẻ và vé được liên kết không được đảm bảo và được coi là 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à trường hợp quan trọng và người dùng phải nhận được thẻ/vé được liên kết, thì bạn nên liên lạc qua một kênh khác để đảm bảo người dùng thêm thẻ/vé.
• Nội dung cập nhật đối với AUP của Google Wallet bao gồm hướng dẫn về việc 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 một đối tượng chính, bạn có thể bỏ qua bước 1.

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

Bạn phải có tải trọng tối thiểu để đặt linkedObjectIds trên thẻ và vé chính. 3 tham số bắt buộc bao gồm:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. 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 thẻ và vé

  …
  {
    "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 thẻ và vé

  …
  "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, những thiết bị có thẻ mà bạn đã cập nhật sẽ nhận được thẻ được liên kết. Thẻ và vé đã liên kết này sẽ được nhóm lại với thẻ và vé chính. Người dùng có thể vuốt sang phải để xem thẻ và vé được liên kết.

Xử lý ngoại lệ

Có thể xảy ra lỗi khi sử dụng API không đúng cách, chẳng hạn như:

Tin nhắn	Lý do
Đối tượng chính và đối tượng được liên kết không có cùng mã nhận dạng tổ chức phát hành.	Bạn không thể đính kèm một đối tượng được liên kết vào đối tượng của một tổ chức 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 làm 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 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 đối tượng được liên kết lồng nhau.	Các đối tượng được liên kết không thể có một đối tượng được 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 các đối tượng được liên kết lồng nhau.	Bản thân đối tượng chính không thể là một đối tượng được liên kết.
Không thể thêm đối tượng được liên kết 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 thẻ và vé chính.