Types de notifications
Ajouter un message et une notification
Contexte
Une fois qu'un utilisateur a ajouté une carte, vous pouvez lui envoyer un message la concernant et vous assurer qu'il en est informé. L'utilisation de la requête Add Message API (Ajouter l'API Message) avec un message_type égal à TEXT_AND_NOTIFY se produit comme suit:
- Un élément "Message" est ajouté au "verso de la carte" (également appelé modèle des détails), et une notification push est envoyée aux utilisateurs une fois la carte enregistrée.
- Lorsque l'utilisateur appuie sur la notification, Google Wallet s'ouvre devant la carte (c'est-à-dire la vue "Carte"), et une accroche s'affiche en haut de l'écran avec le bouton "Afficher le message".
- En cliquant sur l'accroche, les utilisateurs sont redirigés au dos de la carte, où les nouveaux messages non lus sont mis en surbrillance.
Éléments à prendre en compte lorsque vous envoyez des messages contenant des notifications aux utilisateurs
- Les utilisateurs doivent avoir activé les notifications pour que leurs cartes puissent recevoir les notifications push liées aux messages.
- Les messages peuvent contenir des URI vers votre site Web ou votre application. Les liens hypertexte doivent correspondre à un site Web ou à une application liés à la carte. Le fait de rediriger les utilisateurs vers des liens sans rapport avec la carte constitue une violation de la Politique d'utilisation autorisée.
- Vous pouvez envoyer jusqu'à trois messages déclenchant une notification push sur une période de 24 heures. Google peut limiter votre quota de distribution des notifications push s'il estime que vous envoyez du spam à vos utilisateurs.
- La notification push que les utilisateurs voient sur leur écran de verrouillage est contrôlée par Google Wallet.
- Vous pouvez utiliser les méthodes UPDATE ou PATCH pour modifier ou supprimer des données de message à l'aide du point de terminaison de la classe ou de l'objet standard.
Procédure d'intégration
Lorsque vous souhaitez informer les utilisateurs qu'un nouveau message d'émetteur a été ajouté à l'aide de l'API AddMessage, vous devez mettre à jour AddMessageRequest afin que le Message contenant votre nouveau texte contienne TEXT_AND_NOTIFY MessageType
Exemple de requête JSON pour ajouter un message et une notification dans une classe Cartes
…
"id": ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Class message header",
"body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
Exemple de requête JSON pour ajouter un message et une notification dans un objet Cartes
…
"id": OBJECT_ID",
"classId": "ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
Exemple de réponse permettant d'ajouter un message et une notification pour une classe de carte
// The updated resource
…
{
"kind": "walletobjects#walletObjectMessage",
"header": "My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"messageType": "textAndNotify"
},
…
Gestion des exceptions
Si vous tentez d'envoyer une notification plus de trois fois, vous obtiendrez une réponse QuotaExceededException . Toute mise à jour ultérieure de la carte peut être définie à l'aide de TEXT au lieu de TEXT_AND_NOTIFY, comme indiqué dans les étapes d'intégration.