Nhóm nhiều thẻ và vé
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Sử dụng mã nhóm
Theo mặc định, việc thêm nhiều thẻ và vé vào một tài khoản
Đường liên kết Thêm vào Google Wallet sẽ không nhóm các thẻ và vé đó trong
ứng dụng Google Wallet của người dùng. Tuy nhiên, bạn có thể nhóm các thẻ và vé lại với nhau bằng cách tạo
đảm bảo tất cả đều có cùng một mã nhóm. Thẻ và vé được nhóm sẽ xuất hiện cùng nhau
trong ứng dụng Google Wallet. Khi bạn chọn một nhóm thẻ và vé, mỗi thẻ và vé sẽ
sẽ xuất hiện trên băng chuyền.
Bạn có thể nhóm các thẻ và vé với nhau:
- Trong quá trình cấp phép ban đầu
-
Bằng cách sử dụng
update
hoặc
patch
phương thức
Để thêm thẻ và vé vào một nhóm, thuộc tính groupingInfo.groupingId của
bạn phải đặt đối tượng truyền. Tất cả đối tượng truyền có cùng
Giá trị groupingId sẽ được tự động nhóm lại với nhau, ngay cả khi
chúng được thêm riêng biệt.
Ví dụ sau đây cho thấy một thẻ khách hàng thân thiết và mặt hàng được nhóm lại với nhau để
thu hút người dùng sử dụng cả hai trong lần mua hàng tiếp theo.
loyaltyObject = {
"classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
"id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
"state": "ACTIVE",
"groupingInfo": {
# Note the same groupingId value
"groupingId": "combinedGiftCardAndOfferId",
"sortIndex": 1
},
"barcode": {
"type": "QR_CODE",
"value": "QR code"
},
"accountId": "Account id",
"accountName": "Account name",
"loyaltyPoints": {
"label": "Points",
"balance": {
"int": 800
}
}
}
offerObject = {
"classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
"id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
"state": "ACTIVE",
"groupingInfo": {
# Note the same groupingId value
"groupingId": "combinedGiftCardAndOfferId",
"sortIndex": 2
},
"barcode": {
"type": "QR_CODE",
"value": "QR code",
},
}
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eAdding multiple passes to a single Google Wallet link will not group them by default, but you can group them using the same \u003ccode\u003egroupingId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGrouped passes appear together in the Google Wallet app and can be provisioned together or grouped later using the \u003ccode\u003eupdate\u003c/code\u003e or \u003ccode\u003epatch\u003c/code\u003e methods.\u003c/p\u003e\n"],["\u003cp\u003eTo group passes, set the \u003ccode\u003egroupingInfo.groupingId\u003c/code\u003e property to the same value for all passes you want to group.\u003c/p\u003e\n"],["\u003cp\u003ePasses with the same \u003ccode\u003egroupingId\u003c/code\u003e will be automatically grouped, even if added separately, and displayed in a carousel when selected.\u003c/p\u003e\n"]]],["Passes in Google Wallet can be grouped by assigning them a shared `groupingId`. This ensures they appear together as a carousel in the user's wallet. Grouping can occur during initial provisioning or via `update` or `patch` methods. The `groupingInfo.groupingId` property must be set within the pass object to establish the group. All passes with the same `groupingId` are automatically grouped. An example shows a loyalty card and an offer being linked with the same ID.\n"],null,["# Group multiple passes\n\nUse a grouping ID\n-----------------\n\n\nBy default, adding multiple passes to a single\n**Add to Google Wallet** link will not group those passes in the\nuser's Google Wallet app. However, passes can be grouped together by making\nsure they all have the same grouping ID. Grouped passes will appear together\nin the Google Wallet app. When a group of passes is selected, each pass will\nbe shown on a carousel.\n\nPasses can be grouped together:\n\n- During initial provisioning\n- By using the [`update`](/wallet/retail/loyalty-cards/rest/v1/loyaltyobject/update) or [`patch`](/wallet/retail/loyalty-cards/rest/v1/loyaltyobject/patch) methods\n\n\nTo add a pass to a group, the `groupingInfo.groupingId` property of\nthe pass object must be set. All pass objects with the same\n`groupingId` value will be automatically grouped together, even if\nthey were added separately.\n\n\nThe following example shows a loyalty card and offer being grouped together to\nentice the user to make use of both in their next purchase. \n\n```carbon\nloyaltyObject = {\n \"classId\": \"ISSUER_ID.GIFT_CARD_CLASS_SUFFIX\",\n \"id\": \"ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX\",\n \"state\": \"ACTIVE\",\n \"groupingInfo\": {\n # Note the same groupingId value\n \"groupingId\": \"combinedGiftCardAndOfferId\",\n \"sortIndex\": 1\n },\n \"barcode\": {\n \"type\": \"QR_CODE\",\n \"value\": \"QR code\"\n },\n \"accountId\": \"Account id\",\n \"accountName\": \"Account name\",\n \"loyaltyPoints\": {\n \"label\": \"Points\",\n \"balance\": {\n \"int\": 800\n }\n }\n}\n\nofferObject = {\n \"classId\": \"ISSUER_ID.OFFER_CLASS_SUFFIX\",\n \"id\": \"ISSUER_ID.OFFER_OBJECT_SUFFIX\",\n \"state\": \"ACTIVE\",\n \"groupingInfo\": {\n # Note the same groupingId value\n \"groupingId\": \"combinedGiftCardAndOfferId\",\n \"sortIndex\": 2\n },\n \"barcode\": {\n \"type\": \"QR_CODE\",\n \"value\": \"QR code\",\n },\n}\n```"]]
