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 đượ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é chính kèm theo chú thích cho biết một thẻ/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

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ó. Sau đây là một số ví dụ:

  • 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 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 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à 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é đó.
  • Nội dung cập nhật trong Chính sách sử dụng (AUP) của Google Wallet bao gồm 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 một đố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.

Cần có tải trọng tối thiểu để đặt linkedObjectIds trên một lượt truyền 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 đố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, 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ó thể xảy ra lỗi khi sử dụng API không đúng cách, 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à 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 đối tượng được liên kết lồng nhau. Đố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 các đối tượng liên kết lồng nhau. Đố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 thẻ và vé chính.