Benachrichtigungstypen
Nachricht hinzufügen und benachrichtigen
Hintergrund
Nachdem ein Nutzer eine Karte bzw. ein Ticket hinzugefügt hat, solltest du ihm eine Nachricht zu der Karte bzw. dem Ticket senden und ihn darüber informieren. Wenn Sie die Add Message API-Anfrage mit einem message_type gleich TEXT_AND_NOTIFY verwenden, geschieht Folgendes:
- Auf der Rückseite der Karte bzw. des Tickets wird ein Message-Element (Detailvorlage) hinzugefügt und an die Nutzer mit der gespeicherten Karte bzw. dem gespeicherten Ticket wird eine Push-Benachrichtigung gesendet.
- Sobald der Nutzer auf die Benachrichtigung tippt, öffnet sich Google Wallet im Vordergrund der Karte bzw. des Tickets (Kartenansicht) und der Nutzer sieht oben auf dem Bildschirm eine Zusatzinformation mit der Schaltfläche „Nachricht anzeigen“.
- Durch Klicken auf die Zusatzinformationen werden Nutzer zur Rückseite der Karte bzw. des Tickets weitergeleitet, auf der neue ungelesene Nachrichten hervorgehoben sind.
Einige Überlegungen beim Senden von Nachrichten mit Benachrichtigungen an Nutzer
- Nutzer müssen Benachrichtigungen für ihre Karten/Tickets aktiviert haben, um Push-Benachrichtigungen zu Nachrichten zu erhalten.
- Nachrichten können URIs zu Ihrer Website oder App enthalten. Hyperlinks müssen eine Website oder App sein, die sich auf die Karte bzw. das Ticket bezieht. Es verstößt gegen die Richtlinien zur Fairen Nutzung, Nutzer zu Links weiterzuleiten, die nicht mit der Karte bzw. dem Ticket zusammenhängen.
- Sie können innerhalb von 24 Stunden maximal drei Nachrichten senden, die eine Push-Benachrichtigung auslösen. Google kann Ihr Kontingent für die Zustellung von Push-Benachrichtigungen drosseln, wenn es feststellt, dass Sie Ihren Nutzern Spam senden.
- Die Push-Benachrichtigungen, die Nutzer auf dem Sperrbildschirm sehen, wird von Google Wallet gesteuert.
- Mit der Methode UPDATE oder PATCH können Sie Nachrichtendaten mithilfe der regulären Klasse oder des regulären Objektendpunkts bearbeiten oder entfernen.
Integrationsschritte
Wenn Sie Nutzer über eine neue Ausstellernachricht informieren möchten, die mit der AddMessage API hinzugefügt wurde, müssen Sie AddMessageRequest so aktualisieren, dass die Message, die den neuen Text enthält, den MessageType TEXT_AND_NOTIFY anstelle von TEXT hat.
Beispiel für eine JSON-Anfrage zum Hinzufügen einer Nachricht und Benachrichtigung in einer Karten-/Ticketklasse
…
"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"
},
…
Beispiel für eine JSON-Anfrage zum Hinzufügen einer Nachricht und Benachrichtigung in einem Karten-/Ticketobjekt
…
"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"
},
…
Beispiel für eine Antwort zum Hinzufügen einer Nachricht und Benachrichtigung für eine Karten-/Ticketklasse
// 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"
},
…
Ausnahmebehandlung
Wird mehr als dreimal eine Benachrichtigung gesendet, wird die Antwort QuotaExceededException zurückgegeben. Alle weiteren Aktualisierungen der Karte / des Tickets können mit „TEXT“ anstelle von „TEXT_AND_NOTIFY“ festgelegt werden, wie in den Integrationsschritten beschrieben.