Mehrere Bordkarten 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 Bordkarten

Manchmal werden Bordkarten in einer Gruppe statt einzeln verwendet. Eine gemeinsame Szenario: Gruppierung von Tickets für Flüge mit Zwischenstopps Zwischenstopps.

Bordkarten nutzen eine zusätzliche Logik, um Karten/Tickets automatisch zu gruppieren zusammen, wenn sie für die folgenden Eigenschaften dieselben Werte haben:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • Der Aussteller-ID-Teil von FlightObject.id

Wenn sich eine der oben genannten Eigenschaften für zwei Bordkarten unterscheidet, ist sie nicht gruppiert (es sei denn, Sie verwenden groupingInfo). Wie Sie sehen, sind beide Klassen und Objekteigenschaften die automatische Gruppierung beeinflussen. Dadurch werden Bordkarten verschiedener Klassen zu einer Gruppe zusammengefasst (z. B. wenn unterschiedliche Flüge einer Reise unterschiedliche Betreiber hat.