Agrupar vários cartões de embarque

Usar um ID de agrupamento

Por padrão, adicionar vários cartões a um único Adicionar à Carteira do Google não agrupa esses cartões na app Carteira do Google de um usuário. No entanto, os cartões podem ser agrupados garantir que todos tenham o mesmo ID de agrupamento. Os cartões agrupados vão aparecer juntos no app Carteira do Google. Quando um grupo de cartões é selecionado, cada um deles ser mostrados em um carrossel.

Os cartões podem ser agrupados:

  • Durante o provisionamento inicial
  • Ao usar o método update ou patch métodos

Para adicionar um cartão a um grupo, a propriedade groupingInfo.groupingId do o objeto do cartão precisa ser definido. Todos os objetos de cartão com o mesmo O valor groupingId será agrupado automaticamente, mesmo que eles foram adicionados separadamente.

O exemplo a seguir mostra um cartão de fidelidade e uma oferta sendo agrupados para motivar o usuário a usar ambos na próxima compra.

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

Agrupamento automático de cartões de embarque

Às vezes, os cartões de embarque são usados em grupo e não individualmente. Um erro comum nesse caso é o agrupamento de passagens para voos com escala ou vários paradas.

Os cartões de embarque têm uma lógica adicional que os agrupa automaticamente juntos se tiverem os mesmos valores para as seguintes propriedades:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • A parte do ID do emissor de FlightObject.id

Se alguma das propriedades acima for diferente para dois cartões de embarque, elas são agrupadas (a menos que você faça isso usando groupingInfo). Note que tanto a classe e as propriedades do objeto afetam o agrupamento automático. Isso ativa os cartões de embarque classes diferentes sejam agrupadas (por exemplo, quando diferentes na mesma viagem tiverem transportadoras diferentes).