Typy powiadomień
Dodaj wiadomość i powiadomienie
Tło
Gdy użytkownik doda kartę, możesz wysłać mu wiadomość dotyczącą
i upewnić się, że zostali o tym powiadomieni. Przy użyciu interfejsu Add Message API
z żądaniem message_type
równym
TEXT_AND_NOTIFY
:
- „Wiadomość” element jest dodany na „tylnej stronie karty” (nazywane też szczegółami szablon), a użytkownicy z zapisaną kartą otrzymają powiadomienie push.
- Gdy użytkownik kliknie powiadomienie, Portfel Google otworzy się z przodu karty (widok kart), a użytkownik zobaczy objaśnienie na górze karty z napisem „View Message” („Wyświetl wiadomość”) Przycisk
- Po kliknięciu objaśnienia użytkownik zostanie przeniesiony na tylną część karty, nieprzeczytane wiadomości są wyróżnione.
O czym warto pamiętać podczas wysyłania wiadomości z powiadomieniami do użytkowników
- Użytkownicy muszą mieć włączone powiadomienia dotyczące kart, aby otrzymywać powiadomienia push związane z wiadomościami.
- Wiadomości mogą zawierać identyfikatory URI witryny lub aplikacji. Hiperlinki muszą mieć format witrynie lub aplikacji powiązanej z kartą. Narusza to Zasady dopuszczalnego użytkowania aby kierować użytkowników do linków niezwiązanych z kartą.
- Możesz wysłać maksymalnie 3 wiadomości, które powodują wyświetlenie powiadomienia push w jednej Okres 24-godzinny. Google może ograniczyć Twój limit dostarczania powiadomień push, jeśli uzna, że rozsyłasz spam dla swoich użytkowników.
- Powiadomienie push, które użytkownicy widzą na ekranie blokady, jest kontrolowane przez Google Portfel.
- Możesz użyć metody UPDATE lub PATCH metod edycji lub usuwania danych wiadomości przy użyciu zwykłej klasy lub obiektu punktu końcowego.
Etapy integracji
Jeśli chcesz powiadomić użytkowników o nowej wiadomości wydawcy dodanej za pomocą AddMessage API, musisz zaktualizować AddMessageRequest. a komunikat który zawiera nowy tekst, ma parametr MessageType. TEXT_AND_NOTIFY zamiast TEXT.
Przykładowe żądanie JSON dodania wiadomości i powiadomienia w klasie kart
… "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" }, …
Przykładowe żądanie JSON umożliwiające dodanie wiadomości i powiadomienia w obiekcie kart
… "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" }, …
Przykładowa odpowiedź z prośbą o dodanie komunikatu i powiadomienie o klasie karty
// 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" }, …
Obsługa wyjątków
Jeśli spróbujesz wysłać powiadomienie więcej niż 3 razy, wyświetli się Odpowiedź QuotaExceededException . Wszelkie dalsze aktualizacje kartę można ustawić za pomocą „TEXT” zamiast „TEXT_AND_NOTIFY” jak omówiono w sekcji Integracja Kroki.