將多張活動票券分組

使用分組 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",
  },
}

活動票券自動分組

有時活動票券會用在群組中，而不是個別使用。常見的情況是將多張家庭成員的票券分組。

活動票券具有額外的邏輯，可根據下列屬性啟用自動分組：

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • EventObject.id 的核發機構 ID 部分

使用「EventClass.eventId」分組

只要活動票券物件的下列屬性值相同，系統就會自動分組：

  • EventClass.eventId
  • EventObject.id 的核發機構 ID 部分

當活動票券物件符合此條件時，即使 EventClass.eventName 和 EventClass.dateTime.start 不同，系統會將這些物件分組。

不使用「EventClass.eventId」分組

如未設定 EventClass.eventId，只要下列屬性相同，系統就會自動將屬性分組。

  • EventClass.eventName
  • EventClass.dateTime.start
  • EventObject.id 的核發機構 ID 部分