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 liên kết tự động cho phép bạn gửi thêm thẻ và vé cho một người dùng đã có thẻ và vé hiện có của bạn trong Google Wallet. Bạn cũng có thể liên kết trước thẻ và vé vào cổng với thẻ và vé chính khi người dùng lưu thẻ và vé chính (chính). Thẻ và vé được liên kết tự động được nhóm với thẻ và vé chính, trong đó có chú thích phía trên thẻ và vé chính để thông báo cho người dùng rằng thẻ và vé mới đã đượ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
Ví dụ chính về thẻ và vé được liên kết tự động Ví dụ phụ về thẻ và vé được liên kết tự động
Thẻ và vé chính có chú thích cho biết thẻ và 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

Có thể bạn 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ó. Một số 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 thẻ đỗ 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 mã phát hành.
  • 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 không được đảm bảo và được coi là nỗ lực tối đa. 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é đã liên kết, 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é đó.
  • Các nội dung cập nhật đối với Chính sách sử dụng 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 đối tượng chính, bạn có thể bỏ qua bước 1.

  1. Tạo một đối tượng của bất kỳ loại thẻ và vé nào được liệt kê cùng với 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 được liệt kê. Đây sẽ là đối tượng đã liên kết.
  3. Trước hoặc sau khi đối tượng chính được lưu, 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 cần có tải trọng tối thiểu để đặt linkedObjectIds trên thẻ thông hành chính. 3 thông 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 đối tượng được liên kết vào đố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 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, các thiết bị có thẻ và vé mà bạn đã cập nhật sẽ nhận được thẻ và vé được liên kết. Thẻ và vé được liên kết này sẽ được nhóm cùng với thẻ và vé chính. Người dùng có thể xem thẻ và vé đã 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, 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 có cùng mã nhận dạng của tổ chức phát hành. Bạn không thể đính kèm đố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 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 vào API Wallet.
Đố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 liên kết lồng nhau. Đối tượng được liên kết không được có đố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. Đối tượng chính không thể tự là đối tượng được liên kết.
Không thể thêm đối tượng được liên kết nào nữa, đã vượt quá giới hạn. Bạn đã đạt đến giới hạn 50 thẻ và vé được liên kết cho thẻ/vé chính.