Usar um ID de agrupamento
Por padrão, adicionar vários cartões a um único link Adicionar à Carteira do Google não vai agrupá-los no app Carteira do Google do usuário. No entanto, os cartões podem ser agrupados garantindo 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 for selecionado, cada forma de pagamento será ser mostrada em um carrossel.
Os cartões podem ser agrupados:
Para adicionar um cartão a um grupo, a propriedade groupingInfo.groupingId
do
objeto do cartão precisa ser definida. Todos os objetos dos cartões com o mesmo
valor groupingId
serão agrupados automaticamente, mesmo se
eles foram adicionados separadamente.
O exemplo a seguir mostra um cartão de fidelidade e uma oferta sendo agrupados para convencer o usuário a fazer o uso de 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 comum cenário para isso é o agrupamento de passagens para voos com escala ou várias paradas.
Os cartões de embarque têm uma lógica adicional que agrupa automaticamente os cartões 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 não serão
agrupadas (a menos que você faça isso usando groupingInfo
). Como você pode conferir, as classes
e as propriedades do objeto afetam o agrupamento automático. Isso permite o agrupamento de cartões de embarque
de diferentes classes (como quando diferentes voos
na mesma viagem têm companhias aéreas diferentes).