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 đặc biệt hữu ích 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 lên máy bay (ví dụ: web, ứng dụng hoặc kiosk tại sân bay). Các đối tác hàng không có thể sử dụng số tài khoản khách hàng thân thiết của người dùng để liên kết và chuyển thẻ/vé vào Wallet của họ.
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 của chương trình khách hàng thường xuyên 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.
Các phương pháp hay nhất
-
Để cho phép hành khách thường xuyên đăng ký chương trình khách hàng thân thiết một cách dễ dàng, hãy cân nhắc việc bật quy trình Đăng ký / Đăng nhập bằng Google. Sau đó, người dùng sẽ có thể khám phá quy trình đăng ký chương trình khách hàng thân thiết của hãng hàng không của bạn tại nhiều điểm truy cập trong Google Wallet, bao gồm cả thẻ lên máy bay.
- Cân nhắc việc bật tính năng đăng ký bằng một lần nhấp cho các thành viên hiện tại của chương trình khách hàng thân thiết trên ứng dụng Android và trang web của bạn.
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. Trong trường hợp này, thẻ chính là thẻ khách hàng thân thiết và thẻ được liên kết là thẻ lên máy bay. Phần còn lại của tài liệu này sử dụng thuật ngữ rộng hơn – Thẻ và vé được liên kết tự động, thẻ chính và thẻ/vé được liên kết – để mô tả chức năng này.
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.
- 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.
- 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.
- 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.
- 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:
- 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 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"
}
…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. |