Raggruppa più carte d'imbarco

Utilizza un ID raggruppamento

Per impostazione predefinita, l'aggiunta di più tessere a una singola Il link Aggiungi a Google Wallet non raggruppa queste tessere nel nell'app Google Wallet dell'utente. Tuttavia, le tessere possono essere raggruppate assicurati che abbiano tutti lo stesso ID raggruppamento. Le tessere raggruppate verranno visualizzate insieme nell'app Google Wallet. Quando viene selezionato un gruppo di tessere, ognuna verrà mostrato in un carosello.

Le tessere possono essere raggruppate:

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

Per aggiungere una tessera a un gruppo, viene utilizzata la proprietà groupingInfo.groupingId di è necessario impostare l'oggetto pass. Tutti gli oggetti pass con lo stesso Il valore groupingId verrà raggruppato automaticamente, anche se sono stati aggiunti separatamente.

L'esempio seguente mostra una carta fedeltà e un'offerta che vengono raggruppate insieme indurre l'utente a utilizzare entrambi nel 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 delle carte d'imbarco

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

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à sopra indicate è diversa per due carte d'imbarco, verrà non raggruppati (a meno che non lo faccia utilizzando groupingInfo). Come puoi vedere, entrambe le classi e le proprietà degli oggetti influiscono sul raggruppamento automatico. Ciò consente alle carte d'imbarco di classi diverse da raggruppare (ad esempio quando voli diversi nello stesso viaggio hanno operatori diversi).