Agrupar vários ingressos de eventos

Usar um ID de agrupamento

Por padrão, adicionar vários cartões a um único link Adicionar à Carteira do Google não vai agrupar esses cartões no app Carteira do Google do usuário. No entanto, se os cartões tiverem o mesmo ID de agrupamento, eles poderão ser agrupados. Os cartões agrupados vão aparecer juntos no app Carteira do Google. Quando um grupo de cartões for selecionado, cada cartão será ser mostrado em um carrossel.

Os cartões podem ser agrupados:

  • durante o provisionamento inicial;
  • usando os métodos update ou patch.

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 ingressos de um evento

Às vezes, os ingressos de um evento são usados em grupo, e não individualmente. Um caso comum é o agrupamento de ingressos para vários membros da família.

Os ingressos de um evento têm uma lógica adicional que permite o agrupamento automático com base nas seguintes propriedades:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • A parte do ID do emissor de EventObject.id

Agrupamento com EventClass.eventId

Os objetos de ingresso de um evento são agrupados automaticamente quando eles têm os mesmos valores para as seguintes propriedades:

  • EventClass.eventId
  • A parte do ID do emissor de EventObject.id

Quando os objetos de ingresso de um evento atenderem a esse critério, eles serão agrupados mesmo quando EventClass.eventName e EventClass.dateTime.start forem diferentes.

Agrupamento sem EventClass.eventId

Se EventClass.eventId não estiver definido, eles serão agrupados automaticamente se as seguintes propriedades forem as mesmas.

  • EventClass.eventName
  • EventClass.dateTime.start
  • A parte do ID do emissor de EventObject.id