对多张活动门票进行分组

使用分组 ID

默认情况下，向单个添加到 Google 钱包链接添加多张卡券并不会在用户的 Google 钱包应用中将这些卡券分组。不过，您可以将卡券组合在一起，方法是确保它们都具有相同的分组 ID。分组的卡券会一起显示在 Google 钱包应用中。选择一组卡券后，每张卡券都会显示在轮播界面中。

卡券可归为一组：

• 初始配置期间
• 使用 update 或 patch 方法

如需将卡券添加到组，必须设置卡券对象的 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",
  },
}

活动门票自动分组

注意 ：卡券的 groupingInfo 属性将始终优先于活动门票所使用的自动分组逻辑。

有时，活动门票会多人（而不是单独）使用。这种情况的一种常见情况是将多个家庭成员的票券分组。

活动门票具有额外的逻辑，用于根据以下属性进行自动分组：

• EventClass.eventId
• EventClass.eventName
• EventClass.dateTime.start
• EventObject.id 的发卡机构 ID 部分

注意 ：如果设置了 EventClass.eventId，则优先使用它来确定哪些对象会被视为组。

使用“EventClass.eventId”分组

如果活动门票对象的以下属性具有相同的值，则系统会自动分组这些对象：

• EventClass.eventId
• EventObject.id 的发卡机构 ID 部分

如果活动门票对象符合此条件，即使 EventClass.eventName 和 EventClass.dateTime.start 不同，系统也会对这些对象进行分组。

在不使用 EventClass.eventId 的情况下分组

如果未设置 EventClass.eventId，当以下属性相同时，系统会自动将它们分组。

• EventClass.eventName
• EventClass.dateTime.start
• EventObject.id 的发卡机构 ID 部分

注意 ：EventClass.dateTime.start 是可选属性。如果未设置此属性，则仅使用 EventClass.eventName 和 EventObject.id 的“发卡机构 ID”部分来确定分组。