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ó trong Google Wallet của họ. Bạn cũng có thể chuyển đường liên kết trước đến thẻ chính khi người dùng lưu thẻ/vé chính (chính). Thẻ và vé tự động được liên kết được nhóm với thẻ và vé chính kèm theo chú thích phía trên thẻ và vé chính để cho người dùng biết rằng một thẻ và vé mới đã được liên kết. Những 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
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ó. 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ểm 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ã nhà 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à cách hiệu quả 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 rất quan trọng và người dùng phải nhận được thẻ và vé được liên kết, thì bạn nên liên hệ 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 (AUP) của Google Wallet có bao gồm hướng dẫn về việc sử dụng Thẻ và vé được tự động liên kết (bạn phải tuân thủ hướng dẫn này).
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.
- Tạo một đối tượng thuộc loại thẻ và vé bất kỳ được liệt kê với 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 loại truyền 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.
Cần có tải trọng tối thiểu để đặt linkedObjectIds trên lượt truyền 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 đối tượng liên kết vào đối tượng truyền
…
{
"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é đã 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ể xem thẻ và vé được liên kết bằng cách vuốt sang phải.
Xử lý ngoại lệ
Các lỗi tiềm ẩn 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à 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 nhà 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 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 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. | Bản thân đối tượng chính không thể là đố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 giới hạn 50 thẻ và vé được liên kết cho thẻ và vé chính. |