여러 탑승권 그룹화

그룹화 ID 사용

기본적으로 Google 월렛에 추가 링크 하나에 패스 여러 개를 추가해도 사용자의 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",
  },
}

탑승권 자동 그룹화

탑승권을 개별적으로 사용하지 않고 그룹으로 사용하는 경우도 있습니다. 일반적인 시나리오는 기착 또는 경유가 여러 개인 항공편의 티켓 그룹화입니다.

탑승권에는 다음 속성의 값이 동일한 경우 패스를 자동으로 그룹화하는 추가 로직이 있습니다.

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • FlightObject.id의 발급기관 ID 부분

두 탑승권에 대해 위의 속성 중 하나라도 다르면 groupingInfo를 사용하지 않는 한 그룹화되지 않습니다. 위에서 볼 수 있듯이 클래스 속성과 객체 속성 모두 자동 그룹화에 영향을 미칩니다. 이를 통해 서로 다른 클래스의 탑승권을 그룹화할 수 있습니다 (예: 동일한 여정의 여러 항공편에 운항 항공사가 다른 경우).