对多个登机牌分组

使用分组 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 执行此操作)。如您所见,类和对象属性都会影响自动分组。这样一来,就可以将不同类别的登机牌组合在一起(例如当同一行程中的不同航班采用不同的承运航空公司时)。