Regrouper plusieurs billets pour des événements

Utiliser un identifiant de regroupement

Par défaut, ajouter plusieurs cartes à un même Ajouter à Google Wallet ne regroupe pas ces cartes dans le l'application Google Wallet de l'utilisateur. Cependant, vous pouvez regrouper les cartes assurez-vous qu'ils ont tous le même identifiant de regroupement. Les cartes groupées s'afficheront ensemble dans l'application Google Wallet. Lorsqu'un groupe de cartes est sélectionné, chaque carte être affichées dans un carrousel.

Les cartes peuvent être regroupées:

  • Lors du provisionnement initial
  • En utilisant la propriété update ou patch méthodes

Pour ajouter une carte à un groupe, la propriété groupingInfo.groupingId de l'objet de carte doit être défini. Tous les objets Cartes ayant le même La valeur groupingId sera automatiquement regroupée, même si ils ont été ajoutés séparément.

L'exemple suivant montre comment regrouper une carte de fidélité et une offre incitent l'utilisateur à utiliser les deux lors de son prochain achat. 

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

Regroupement automatique de billets pour un événement

Les billets pour des événements sont parfois utilisés au sein d'un groupe plutôt qu'individuellement. Une approche scénario pour cela est le regroupement de tickets pour plusieurs membres de la famille.

Les billets pour des événements utilisent une logique supplémentaire qui permet de les regrouper automatiquement en fonction les propriétés suivantes:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • La partie ID de l'émetteur de EventObject.id

Regroupement avec EventClass.eventId

Les objets de billet pour un événement sont regroupés automatiquement lorsqu'ils ont la même valeur. pour les propriétés suivantes:

  • EventClass.eventId
  • La partie ID de l'émetteur de EventObject.id

Lorsque les objets de billet pour un événement répondent à ces critères, ils sont regroupés même si EventClass.eventName et EventClass.dateTime.start sont différents.

Regroupement sans EventClass.eventId

Si EventClass.eventId n'est pas défini, ils sont automatiquement regroupés si la les propriétés suivantes sont identiques.

  • EventClass.eventName
  • EventClass.dateTime.start
  • La partie ID de l'émetteur de EventObject.id