Memicu Notifikasi Push

Jenis Pemberitahuan

Tambahkan Pesan dan Beri Tahu

Latar belakang

Setelah pengguna menambahkan kartu, Anda mungkin ingin mengirimi mereka pesan terkait lulus dan memastikan mereka diberi tahu tentang hal itu. Menggunakan Add Message API permintaan dengan message_type yang sama dengan TEXT_AND_NOTIFY hal berikut terjadi:

  1. "Pesan" item ditambahkan ke "bagian belakang kartu" (disebut juga Detail Template) dan notifikasi push akan dikirimkan ke pengguna dengan kartu yang disimpan.
  2. Setelah pengguna mengetuk notifikasi, Google Wallet akan terbuka di bagian depan kartu (alias tampilan Kartu) dan pengguna akan melihat info di bagian atas layar dengan pesan "Lihat Pesan" tombol.
  3. Mengklik info akan membawa pengguna ke bagian belakang kartu, tempat pesan yang belum dibaca disorot.

Beberapa pertimbangan saat mengirim pesan dengan notifikasi kepada pengguna

  • Pengguna harus mengaktifkan notifikasi agar kartu mereka dapat menerima notifikasi push yang terkait dengan pesan.
  • Pesan dapat berisi URI ke situs atau aplikasi Anda. Hyperlink harus berupa situs atau aplikasi yang terkait dengan kartu tersebut. Contoh ini merupakan pelanggaran Kebijakan Penggunaan yang Dapat Diterima untuk mengarahkan pengguna ke link yang tidak terkait dengan kartu.
  • Anda dapat mengirim maksimal 3 pesan yang memicu notifikasi push dalam Periode 24 jam. Google mungkin membatasi kuota pengiriman notifikasi push Anda jika menganggap Anda mengirimkan spam kepada pengguna.
  • Notifikasi push yang dilihat pengguna di layar kunci mereka dikontrol oleh Google Dompet.
  • Anda dapat menggunakan UPDATE atau PATCH metode untuk mengedit atau menghapus data pesan menggunakan class atau objek reguler endpoint.

Langkah-Langkah Integrasi

Saat Anda ingin memberi tahu pengguna tentang pesan penerbit baru yang ditambahkan menggunakan AddMessage API, Anda harus memperbarui AddMessageRequest sehingga Message yang berisi teks baru Anda memiliki MessageType TEXT_AND_NOTIFY, bukan TEXT.

Contoh Permintaan JSON untuk menambahkan pesan dan memberi tahu di Kelas Kartu

  …
  "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"
    },
  …

Contoh Permintaan JSON untuk menambahkan pesan dan memberi tahu dalam Objek Kartu

  …
  "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"
    },
  …

Contoh Respons untuk menambahkan pesan dan memberi tahu tentang Kelas Kartu

  // 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"
    },
  …

Penanganan pengecualian

Setiap upaya untuk memberi tahu lebih dari 3 kali akan menghasilkan QuotaExceededException . Semua pembaruan lebih lanjut pada kartu dapat disetel menggunakan "TEXT" bukannya "TEXT_AND_NOTIFY" seperti yang dibahas dalam Integrasi Langkah-langkah.