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.
Để 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.
Đôi khi, thẻ lên máy bay được dùng theo nhóm thay vì từng thẻ. Điểm chung
trường hợp này là nhóm vé cho các chuyến bay quá cảnh hoặc có nhiều
dừng.
Thẻ lên máy bay có logic bổ sung sẽ tự động nhóm các thẻ và vé
với nhau nếu chúng có cùng giá trị cho các thuộc tính sau:
FlightClass.flightHeader.carrier.carrierIataCode
FlightClass.flightHeader.flightNumber
FlightClass.localScheduledDepartureDateTime
FlightObject.reservationInfo.confirmationCode
Phần Mã nhà phát hành của FlightObject.id
Nếu bất kỳ thuộc tính nào ở trên khác nhau đối với hai thẻ lên máy bay, thì chúng
không được nhóm (trừ phi bạn làm vậy bằng cách sử dụng groupingInfo). Như bạn có thể thấy, cả hai lớp
và thuộc tính đối tượng ảnh hưởng đến việc nhóm tự động. Thao tác này sẽ bật Thẻ lên máy bay
hạng khác nhau được nhóm lại với nhau (chẳng hạn như khi các chuyến bay khác nhau
trong cùng một chuyến đi nhưng có nhiều hãng vận hành khác nhau).
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-04 UTC."],[[["\u003cp\u003eMultiple passes added to a single Google Wallet link can be grouped together using the same \u003ccode\u003egroupingId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGrouped passes are displayed together in the Google Wallet app and can be provisioned together or grouped later via update/patch methods.\u003c/p\u003e\n"],["\u003cp\u003eBoarding passes have automatic grouping logic based on shared flight details, but using the \u003ccode\u003egroupingInfo\u003c/code\u003e property overrides this automatic grouping.\u003c/p\u003e\n"]]],["Passes in Google Wallet can be grouped by assigning them a shared `groupingId` property, ensuring they appear together in the app. This grouping can occur during the initial provisioning or via `update` or `patch` methods. Boarding passes also have automatic grouping based on properties like carrier code, flight number, departure time, and confirmation code. Setting a `groupingInfo` overrides this automatic logic. A loyalty card and offer could be grouped using the same `groupingId`.\n"],null,["# Group multiple Boarding 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/tickets/boarding-passes/rest/v1/flightobject/update) or [`patch`](/wallet/tickets/boarding-passes/rest/v1/flightobject/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```\n\nBoarding pass automatic grouping\n--------------------------------\n\n| **Note:** The `groupingInfo` property of a pass will always take precedence over the automatic grouping logic used by Boarding passes.\n\nSometimes boarding passes are used in a group rather than individually. A common\nscenario for this is grouping of tickets for flights with layovers or multiple\nstops.\n\nBoarding passes have additional logic that will automatically group passes\ntogether if they have the same values for the following properties:\n\n- `FlightClass.flightHeader.carrier.carrierIataCode`\n- `FlightClass.flightHeader.flightNumber`\n- `FlightClass.localScheduledDepartureDateTime`\n- `FlightObject.reservationInfo.confirmationCode`\n- The Issuer ID portion of `FlightObject.id`\n\nIf any of the above properties are different for two Boarding passes, they are\nnot grouped (unless you do so using `groupingInfo`). As you can see, both class\nand object properties affect automatic grouping. This enables Boarding passes\nof different classes to be grouped together (such as when different flights\nin the same trip have different operating carriers)."]]