Grupowanie wielu kart pokładowych

Użyj identyfikatora grupy

Domyślnie dodanie wielu kart do jednego linku Dodaj do Portfela Google nie powoduje grupowania ich w aplikacji Portfel Google użytkownika. Można jednak grupować karty, upewniając się, że wszystkie mają ten sam identyfikator grupowania. Zgrupowane karty będą wyświetlać się razem w aplikacji Portfel Google. Po wybraniu grupy kart każda karta będzie wyświetlana w karuzeli.

Karty można grupować:

  • Podczas wstępnej obsługi administracyjnej
  • Za pomocą metody update lub patch

Aby dodać kartę do grupy, musisz ustawić właściwość groupingInfo.groupingId obiektu karty. Wszystkie obiekty biletu z tą samą wartością groupingId będą automatycznie grupowane, nawet jeśli zostały dodane oddzielnie.

Poniższy przykład pokazuje, jak karta lojalnościowa i oferta są grupowane, aby zachęcić użytkownika do skorzystania z obu tych opcji przy kolejnym 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 karty pokładowej

Czasami karty pokładowe są używane w grupie, a nie pojedynczo. Typowym scenariuszem jest grupowanie biletów na loty z przesiadkami lub z kilkoma przesiadkami.

Karty pokładowe mają dodatkową logikę, która automatycznie grupuje karty, jeśli mają te same wartości dla 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óreś z tych właściwości są różne w przypadku dwóch kart pokładowych, nie zostaną one zgrupowane (chyba że użyjesz właściwości groupingInfo). Jak widać, właściwości klas i obiektów wpływają na automatyczne grupowanie. Dzięki temu można grupować karty pokładowe różnych klas (np. gdy różne loty w ramach tej samej podróży korzystają z różnych przewoźników).