Uruchamiaj powiadomienia push

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:

  1. „Wiadomość” element jest dodany na „tylnej stronie karty” (nazywane też szczegółami szablon), a użytkownicy z zapisaną kartą otrzymają powiadomienie push.
  2. 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
  3. 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.