複数のイベント チケットをグループ化する

グループ ID を使用する

デフォルトでは、1 つのプロジェクトに複数のパスを [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",
  },
}

イベント チケットの自動グループ化

イベント チケットが、個々のチケットではなくグループで使用されることがあります。共通 複数のファミリー メンバーのチケットをグループ化する場合のシナリオです。

イベント チケットには、イベントに基づいて自動的にグループ化する追加のロジックがあります。 次のプロパティがあります。

  • 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 の部分
で確認できます。