Déclencher des notifications push

Types de notifications

Ajouter un message et envoyer une notification

Contexte

Une fois qu'un utilisateur a ajouté une carte, vous pouvez lui envoyer un message concernant la carte et vous assurer qu'il en soit informé. En utilisant la requête API Add Message avec un message_type égal à TEXT_AND_NOTIFY, le résultat est le suivant :

  1. Un élément Message est ajouté au dos de la carte (ou modèle détaillé), et une notification push est envoyée aux utilisateurs avec la carte enregistrée.
  2. Lorsque l'utilisateur appuie sur la notification, Google Wallet s'ouvre au premier plan de la carte (c'est-à-dire la vue Carte). Une accroche avec un bouton "Afficher le message" s'affiche en haut de l'écran.
  3. En cliquant sur le callout, les utilisateurs sont redirigés vers l'arrière de la carte, où les nouveaux messages non lus sont mis en évidence.

Éléments à prendre en compte lors de l'envoi de messages avec notifications aux utilisateurs

  • Les utilisateurs doivent avoir activé les notifications pour leurs cartes afin de recevoir les notifications push liées aux messages.
  • Les messages peuvent contenir des URI vers votre site Web ou votre application. Les liens hypertextes doivent être des sites Web ou des applications associés à la carte. Le fait de rediriger les utilisateurs vers des liens sans rapport avec la carte enfreint la Politique d'utilisation autorisée.
  • Vous pouvez envoyer un maximum de trois messages déclenchant une notification push sur une période de 24 heures. Google peut limiter votre quota de distribution de notifications push si nous estimons 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 les données d'un message à l'aide du point de terminaison de classe ou d'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 pour que le Message contenant votre nouveau texte présente le MessageType TEXT_AND_NOTIFY au lieu de TEXT.

Exemple de requête JSON pour ajouter un message et une notification dans une classe de 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 "Passes"

  …
  "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 envoyer 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 de notification supérieure à trois fois génère une réponse QuotaExceededException. Toute autre mise à jour 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.