Tự động thêm thẻ lên máy bay

Thông tin khái quát

Tính năng này cho phép các hãng hàng không tự động gửi thẻ lên máy bay đến Google Wallet của người dùng. Điều này sẽ đặc biệt có lợi cho những hành khách thường xuyên bay vì họ sẽ có thể thêm thẻ lên máy bay vào Wallet một cách đơn giản và dễ dàng hơn do tần suất đi lại cao hơn.

Quá trình này diễn ra tự động bất kể kênh làm thủ tục check-in (ví dụ: web, ứng dụng hoặc ki-ốt tại sân bay). Hãng hàng không sử dụng số tài khoản khách hàng thân thiết của người dùng để tương quan và gửi thẻ/vé.

Lưu ý: Tính năng này là một cách triển khai cụ thể của tính năng "Thẻ và vé được liên kết tự động". Phần còn lại của tài liệu sử dụng thuật ngữ rộng hơn là "Thẻ và vé được liên kết tự động", cũng như "thẻ và vé chính" và "thẻ và vé được liên kết" để mô tả chức năng này.

Cách hoạt động của tính năng này

Bước 1: Cho phép hành khách thường xuyên thêm thẻ khách hàng thân thiết vào Wallet.

Bước 2: Tự động thêm thẻ lên máy bay mới cho khách bay thường xuyên bằng cách liên kết thẻ lên máy bay với thẻ khách hàng thân thiết của họ trong Wallet.

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 chuyển thẻ và vé đã 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ẻ 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ẻ.
• 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 bất kỳ loại thẻ và vé nào đượ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ư: