將多張活動票券分組

使用分組 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.eventNameEventClass.dateTime.start 不同。

不使用 EventClass.eventId 分組

如未設定 EventClass.eventId,系統會在 如下所示的屬性。

  • EventClass.eventName
  • EventClass.dateTime.start
  • EventObject.id 的核發者 ID 部分
,瞭解如何調查及移除這項存取權。