Memicu Notifikasi Push

Jenis Pemberitahuan

Tambahkan Pesan dan Beri Tahu

Latar belakang

Setelah pengguna menambahkan kartu, Anda dapat mengirim pesan terkait kartu tersebut kepada mereka dan memastikan mereka diberi tahu. Dengan menggunakan permintaan Add Message API dengan message_type sama dengan TEXT_AND_NOTIFY, hal berikut akan terjadi:

  1. Item "Pesan" ditambahkan ke "bagian belakang kartu" (alias Template Detail) dan notifikasi push dikirim 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 tombol "Lihat Pesan".
  3. Mengklik info akan mengarahkan pengguna ke bagian belakang kartu, tempat pesan baru yang belum dibaca ditandai.

Beberapa pertimbangan saat mengirim pesan dengan notifikasi kepada pengguna

  • Pengguna harus mengaktifkan notifikasi agar kartunya 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. Mengirim pengguna ke link yang tidak terkait dengan kartu merupakan pelanggaran terhadap Kebijakan Penggunaan yang Dapat Diterima.
  • Anda dapat mengirim maksimal 3 pesan yang memicu notifikasi push dalam periode 24 jam. Google dapat membatasi kuota pengiriman notifikasi push Anda jika dianggap telah mengirimkan spam kepada pengguna.
  • Notifikasi push yang dilihat pengguna di layar kunci mereka dikontrol oleh Google Wallet.
  • Anda dapat menggunakan metode UPDATE atau PATCH untuk mengedit atau menghapus data pesan menggunakan endpoint class atau objek reguler.

Langkah-Langkah Integrasi

Jika 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 Class 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 pemberitahuan 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 untuk Class 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 respons QuotaExceededException . Pembaruan lebih lanjut pada kartu dapat ditetapkan menggunakan "TEXT", bukan "TEXT_AND_NOTIFY" seperti yang dibahas dalam Langkah-langkah Integrasi.