Benachrichtigungstypen
Nachricht hinzufügen und benachrichtigen
Hintergrund
Nachdem ein Nutzer eine Karte bzw. ein Ticket hinzugefügt hat, können Sie ihm eine Nachricht zu den
bestanden haben, und stellen Sie sicher, dass sie darüber benachrichtigt werden. Add Message API verwenden
mit einem message_type
gleich
TEXT_AND_NOTIFY
tritt Folgendes ein:
- Eine Message (Nachricht) Das Element wird der Kartenrückseite hinzugefügt. (auch Details Vorlage) und eine Push-Benachrichtigung wird an die Nutzer mit der gespeicherten Karte bzw. dem Ticket gesendet.
- Sobald der Nutzer auf die Benachrichtigung tippt, wird Google Wallet im Vordergrund geöffnet. die Karte bzw. das Ticket an. Der Nutzer sieht oben auf der Karte mit der Meldung „Nachricht anzeigen“ Schaltfläche.
- Durch Klicken auf die Zusatzinformationen gelangen Nutzer zur Rückseite der Karte bzw. des Tickets, wo neue ungelesene Nachrichten werden hervorgehoben.
Einige Überlegungen beim Senden von Nachrichten mit Benachrichtigungen an Nutzer
- Nutzer müssen Benachrichtigungen aktiviert haben, damit ihre Karten/Tickets die Push-Benachrichtigungen zu Nachrichten.
- Nachrichten können URIs zu Ihrer Website oder App enthalten. Hyperlinks müssen Website oder App, die mit der Karte bzw. dem Ticket in Verbindung stehen. Es stellt einen Verstoß gegen die Richtlinien zur Fairen Nutzung um Nutzer zu Links weiterzuleiten, die nicht mit der Karte bzw. dem Ticket zusammenhängen.
- Sie können maximal drei Nachrichten senden, die eine Push-Benachrichtigung in einer innerhalb von 24 Stunden. Google kann Ihr Kontingent für Push-Benachrichtigungen drosseln, wenn dies vermutet, dass ihr eure Nutzer mit Spam überflutet.
- Die Push-Benachrichtigung, die Nutzer auf dem Sperrbildschirm sehen, wird von Google gesteuert Brieftasche.
- Sie können die Methode UPDATE oder PATCH Methoden zum Bearbeiten oder Entfernen von Nachrichtendaten mithilfe der regulären Klasse oder des regulären Objekts Endpunkt.
Integrationsschritte
Wenn Sie Nutzer über eine neue Ausstellernachricht benachrichtigen möchten, die mithilfe der AddMessage API verwenden möchten, müssen Sie die AddMessageRequest damit die Message die Ihren neuen Text enthält, hat den MessageType TEXT_AND_NOTIFY anstelle von TEXT
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, QuotaExceededException -Fehler zurückgegeben. Alle weiteren Aktualisierungen der Karte/Ticket kann mit "TEXT" festgelegt werden anstelle von „TEXT_AND_NOTIFY“ wie im Abschnitt Integration Schritte: