Kích hoạt thông báo đẩy

Loại thông báo

Thêm tin nhắn và thông báo

Thông tin khái quát

Sau khi người dùng thêm thẻ và vé, bạn nên gửi cho họ thông báo liên quan đến và đảm bảo họ được thông báo về việc đó. Sử dụng Add Message API (Thêm API Thư) yêu cầu có message_type bằng TEXT_AND_NOTIFY các trường hợp sau sẽ xảy ra:

  1. "Tin nhắn" mục được thêm vào phần "mặt sau của thẻ và vé" (còn gọi là Chi tiết mẫu) và một thông báo đẩy sẽ được gửi cho người dùng khi thẻ/vé đã lưu.
  2. Khi người dùng nhấn vào thông báo, thông báo sẽ mở Google Wallet ở phía trước thẻ và vé (còn gọi là chế độ xem thẻ) và người dùng sẽ thấy một chú thích ở đầu màn hình hiển thị thông báo "Xem thông báo" .
  3. Khi nhấp vào chú thích, người dùng sẽ được đưa đến mặt sau của thẻ/vé, nơi mới tin nhắn chưa đọc được đánh dấu.

Một số điều cần cân nhắc khi gửi thông báo kèm thông báo cho người dùng

  • Người dùng phải bật tính năng thông báo thì thẻ và vé của họ mới nhận được thông báo đẩy liên quan đến tin nhắn.
  • Tin nhắn có thể chứa URI đến trang web hoặc ứng dụng của bạn. Siêu liên kết phải là trang web hoặc ứng dụng liên quan đến thẻ và vé. Đây là hành vi vi phạm Chính sách sử dụng để đưa người dùng đến các đường liên kết không liên quan đến thẻ và vé.
  • Bạn có thể gửi tối đa 3 tin nhắn để kích hoạt thông báo đẩy trong một Khoảng thời gian 24 giờ. Google có thể điều tiết hạn mức gửi thông báo đẩy của bạn nếu cho rằng bạn đang gửi spam cho người dùng của mình.
  • Thông báo đẩy mà người dùng nhìn thấy trên màn hình khoá là do Google kiểm soát Ví.
  • Bạn có thể sử dụng hàm CẬP NHẬT hoặc PATCH các phương thức để chỉnh sửa hoặc xoá dữ liệu thông báo bằng lớp hoặc đối tượng thông thường điểm cuối.

Các bước tích hợp

Khi bạn muốn thông báo cho người dùng về thông báo mới của nhà phát hành, đã thêm bằng cách sử dụng AddMessage API, bạn sẽ cần cập nhật AddMessageRequest để Thông báo trong đó chứa văn bản mới của bạn có MessageType TEXT_AND_NOTIFY thay vì TEXT_AND_NOTIFY.

Ví dụ về Yêu cầu thêm tin nhắn và thông báo trong Lớp thẻ và vé ở định dạng JSON

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

Ví dụ về Yêu cầu thêm tin nhắn và thông báo trong Đối tượng thẻ và vé ở định dạng JSON

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

Ví dụ về Phản hồi để thêm thông báo và thông báo cho một Lớp thẻ và vé

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

Xử lý ngoại lệ

Nếu bạn cố gắng thông báo nhiều hơn 3 lần, thì Phản hồi QuotaExceededException . Bất kỳ cập nhật nào khác đối với có thể đặt thẻ/vé bằng cách sử dụng "TEXT" thay vì "TEXT_AND_NOTIFY như được thảo luận trong bài viết Tích hợp Các bước.