Raggruppa più carte d'imbarco

Utilizza un ID raggruppamento

Per impostazione predefinita, l'aggiunta di più tessere a un singolo link Aggiungi a Google Wallet non comporta il raggruppamento delle tessere nell'app Google Wallet dell'utente. Tuttavia, le tessere possono essere raggruppate assicurandoti che abbiano tutte lo stesso ID di raggruppamento. Le tessere raggruppate verranno visualizzate insieme nell'app Google Wallet. Quando viene selezionato un gruppo di tessere, ogni tessera verrà mostrata in un carosello.

I pass possono essere raggruppati:

  • Durante il provisioning iniziale
  • Utilizzando i metodi update o patch

Per aggiungere una tessera a un gruppo, è necessario impostare la proprietà groupingInfo.groupingId dell'oggetto pass. Tutti gli oggetti trasmessi con lo stesso valore groupingId verranno raggruppati automaticamente, anche se sono stati aggiunti separatamente.

L'esempio seguente mostra una carta fedeltà e un'offerta raggruppate per invogliare l'utente a utilizzare entrambe nel suo prossimo acquisto. 

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

Raggruppamento automatico carte d'imbarco

A volte le carte d'imbarco vengono utilizzate in gruppo anziché singolarmente. Uno scenario comune è il raggruppamento di biglietti per voli con scali o con più scali.

Le carte d'imbarco hanno una logica aggiuntiva che raggruppa automaticamente le tessere se hanno gli stessi valori per le seguenti proprietà:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • La parte dell'ID emittente di FlightObject.id

Se una qualsiasi delle proprietà precedenti è diversa per due carte d'imbarco, non vengono raggruppate (a meno che non utilizzi groupingInfo). Come puoi vedere, sia le proprietà di classe che di oggetto influiscono sul raggruppamento automatico. Ciò consente di raggruppare le carte d'imbarco di classi diverse (ad esempio quando voli diversi nello stesso viaggio hanno vettori operativi diversi).