Memicu Notifikasi Push

Jenis Pemberitahuan

Tambahkan Pesan dan Beri Tahu

Latar belakang

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

  1. Item "Message" ditambahkan ke "back of pass" (alias Details Template) dan notifikasi push akan dikirim ke pengguna dengan kartu yang tersimpan.
  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 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. Mengarahkan pengguna ke link yang tidak terkait dengan kartu merupakan pelanggaran terhadap Kebijakan Penggunaan yang Dapat Diterima.
  • Anda dapat mengirim maksimum 3 pesan yang memicu notifikasi push dalam periode 24 jam. Google dapat membatasi kuota pengiriman notifikasi push jika Anda mendapati bahwa Anda melakukan spamming kepada pengguna.
  • Notifikasi push yang dilihat pengguna di layar kunci dikontrol oleh Google Wallet.
  • Anda dapat menggunakan metode UPDATE atau PATCH untuk mengedit atau menghapus data pesan menggunakan endpoint objek atau class reguler.

Langkah-Langkah Integrasi

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

Contoh Permintaan JSON untuk menambahkan pesan dan memberi tahu dalam 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 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 untuk suatu Kelas Lulus

  // 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 . Setiap pembaruan lebih lanjut pada pass dapat ditetapkan menggunakan "TEXT" bukan "TEXT_AND_NOTIFY" seperti yang dibahas dalam Langkah Integrasi.