將多張活動票券分組

使用分組 ID

根據預設，將多張票證新增至單一 「新增至 Google 錢包」連結並不會將票證中的票證 使用者的 Google 錢包應用程式。但若要將票證分組 確認它們的分組 ID 都相同。分組的票證會一起顯示 。如果選取一組票證，每張票證會 顯示在輪轉介面中

票證可以分組：

  • 初始佈建期間
  • 使用 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",
  },
}

活動票券自動分組

有時活動票券是用在群組中，而不是個別使用。常見的 具體來說，就是為多位家庭成員將票券分組。

活動票券還提供額外的邏輯，可根據下列項目自動分組： 並列出以下屬性：

  • 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 部分
，瞭解如何調查及移除這項存取權。