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 concernant la
et vous assurer qu'ils en sont informés. À l'aide de l' API Add Message
avec une valeur message_type
égale à
TEXT_AND_NOTIFY
se produit comme suit:
- Un "Message" est ajouté au "verso de la carte" (ou Détails modèle) et une notification push est envoyée aux utilisateurs avec la carte enregistrée.
- Lorsque l'utilisateur appuie sur la notification, Google Wallet s'ouvre. de la carte (c'est-à-dire la vue Fiche) et une accroche s'affiche en haut de la avec le message « Afficher le message » .
- En cliquant sur l'accroche, les utilisateurs sont redirigés vers l'arrière de la carte, où de nouveaux messages non lus sont mis en surbrillance.
Éléments à prendre en compte lors de l'envoi de messages avec notifications aux utilisateurs
- Les utilisateurs doivent activer les notifications pour que leurs cartes puissent recevoir la et les notifications push liées aux messages.
- Les messages peuvent contenir des URI vers votre site Web ou votre application. Les liens hypertexte doivent être vers le site Web ou l'application associés à la carte. Cette vidéo enfreint le Politique d'utilisation autorisée pour rediriger les utilisateurs vers des liens sans rapport avec la carte.
- Vous pouvez envoyer jusqu'à trois messages qui déclenchent une notification push dans un Période de 24 heures. Il est possible que Google limite votre quota de distribution de notifications push considère que vous envoyez du spam à vos utilisateurs.
- Les notifications push que les utilisateurs voient sur leur écran de verrouillage sont contrôlées par Google. Google Wallet.
- Vous pouvez utiliser la méthode UPDATE ou PATCH pour modifier ou supprimer des données de message à l'aide de la classe ou de l'objet standard point de terminaison unique.
Procédure d'intégration
Lorsque vous souhaitez informer les utilisateurs qu'un nouveau message d'émetteur a été ajouté à l'aide de la méthode l'API AddMessage, vous devez mettre à jour AddMessageRequest. afin que le champ Message qui contient le nouveau texte, et dont l'élément MessageType TEXT_AND_NOTIFY au lieu de TEXT.
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 pour 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
Toute tentative d'envoi de cette notification plus de trois fois donnera lieu QuotaExceededException . Toute autre mise à jour peut être définie à l'aide de "TEXT" au lieu de TEXT_AND_NOTIFY comme indiqué dans la section Intégration Étapes.