使用分组 ID
默认情况下,向单个添加到 Google 钱包链接添加多张卡券并不会在用户的 Google 钱包应用中将这些卡券分组。不过,您可以将卡券组合在一起,方法是确保它们都具有相同的分组 ID。分组的卡券会一起显示在 Google 钱包应用中。选择一组卡券后,每张卡券都会显示在轮播界面中。
卡券可归为一组:
如需将卡券添加到组,必须设置卡券对象的 groupingInfo.groupingId
属性。具有相同 groupingId
值的所有传递对象都会自动归为一组,即使单独添加这些对象也是如此。
以下示例展示了将会员卡和优惠组合在一起,以吸引用户在下次购买时同时使用两者。
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", }, }
登机牌自动分组
登机牌有时需要成组(而非单独)使用。这种情况的一种常见情况是为需要中转或多次经停的航班分组机票。
如果登机牌的以下属性具有相同的值,则登机牌具有额外的逻辑,可以自动将它们组合在一起:
FlightClass.flightHeader.carrier.carrierIataCode
FlightClass.flightHeader.flightNumber
FlightClass.localScheduledDepartureDateTime
FlightObject.reservationInfo.confirmationCode
FlightObject.id
的发卡机构 ID 部分
如果两个登机牌的上述任何属性不同,它们将不会分组(除非您使用 groupingInfo
执行此操作)。如您所见,类和对象属性都会影响自动分组。这样一来,就可以将不同类别的登机牌组合在一起(例如当同一行程中的不同航班采用不同的承运航空公司时)。