Grupowanie wielu kart pokładowych

Użyj identyfikatora grupy

Domyślnie dodawanie wielu kart do jednej karty Link Dodaj do Portfela Google nie grupuje tych kart w w aplikacji Portfel Google użytkownika. Karty można jednak grupować, tworząc upewnij się, że wszystkie mają ten sam identyfikator grupy. Zgrupowane karty będą się wyświetlać razem w aplikacji Portfel Google. Po wybraniu grupy kart każda z nich zostanie będą wyświetlane w karuzeli.

Karty można grupować:

  • Podczas wstępnego udostępniania
  • Za pomocą update lub patch metod

Aby dodać kartę do grupy, właściwość groupingInfo.groupingId musisz ustawić obiekt karty. Wszystkie obiekty przekazujące z takim samym Wartość groupingId będzie automatycznie zgrupowana, nawet jeśli zostały dodane oddzielnie.

Przykład poniżej pokazuje kartę lojalnościową i ofertę pogrupowane według grup zachęcić użytkowników do skorzystania z obu tych narzędzi przy następnym zakupie. 

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

Automatyczne grupowanie kart pokładowych

Czasami karty pokładowe są używane w grupie, a nie pojedynczo. Częstym dla tego scenariusza jest grupowanie biletów na loty z przesiadkami lub z wieloma przystanki.

Karty pokładowe mają dodatkową logikę, która automatycznie grupuje karty razem, jeśli mają te same wartości tych właściwości:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • Część identyfikatora wydawcy FlightObject.id

Jeśli któraś z tych właściwości jest inna w przypadku dwóch kart pokładowych, nie zgrupowane (chyba że użyjesz w tym celu funkcji groupingInfo). Jak widać, obie klasy na automatyczne grupowanie. Umożliwia to korzystanie z kart pokładowych różnych klas do zgrupowania (np. w przypadku różnych emisji w ramach tej samej podróży mają różnych przewoźników).