Mehrere Veranstaltungstickets gruppieren

Gruppierungs-ID verwenden

Standardmäßig ist das Hinzufügen mehrerer Karten/Tickets zu einer einzelnen Beim Link Zu Google Wallet hinzufügen werden diese Karten/Tickets nicht im über die Google Wallet App des Nutzers. Karten/Tickets können jedoch gruppiert werden, indem dass sie alle dieselbe Gruppierungs-ID haben. Gruppierte Karten/Tickets werden zusammen angezeigt in der Google Wallet App. Wenn eine Gruppe von Karten/Tickets ausgewählt wird, in einem Karussell angezeigt werden.

Karten/Tickets können so gruppiert werden:

  • Während der anfänglichen Bereitstellung
  • Mit der Methode update oder patch Methoden

Um einer Gruppe eine Karte bzw. ein Ticket hinzuzufügen, muss das Attribut groupingInfo.groupingId von Das Karten-/Ticketobjekt muss festgelegt werden. Alle Karten-/Ticketobjekte mit derselben Der groupingId-Wert wird automatisch gruppiert, auch wenn wurden sie separat hinzugefügt.

Das folgende Beispiel zeigt, wie eine Kundenkarte und ein Angebot den Nutzer dazu verleiten, beide beim nächsten Einkauf zu verwenden.

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",
  },
}

Automatische Gruppierung von Veranstaltungstickets

Manchmal werden Veranstaltungstickets in einer Gruppe statt einzeln verwendet. Eine gemeinsame ist die Gruppierung von Tickets für mehrere Familienmitglieder.

Veranstaltungstickets haben eine zusätzliche Logik, die die automatische Gruppierung basierend auf folgenden Eigenschaften:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • Der Aussteller-ID-Teil von EventObject.id

Gruppierung mit EventClass.eventId

Veranstaltungsticketobjekte werden automatisch gruppiert, wenn sie dieselben Werte haben für die folgenden Properties:

  • EventClass.eventId
  • Der Aussteller-ID-Teil von EventObject.id

Wenn Veranstaltungsticketobjekte diese Kriterien erfüllen, werden sie auch dann gruppiert, EventClass.eventName und EventClass.dateTime.start sind unterschiedlich.

Gruppierung ohne EventClass.eventId

Ist EventClass.eventId nicht festgelegt, werden sie automatisch gruppiert, wenn das sind die folgenden Eigenschaften identisch.

  • EventClass.eventName
  • EventClass.dateTime.start
  • Der Aussteller-ID-Teil von EventObject.id