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ọ một thông báo liên quan đến thẻ và vé đó và đảm bảo họ được thông báo về thẻ đó. Khi sử dụng yêu cầu Add Message API (Thêm API thông báo) có message_type bằng TEXT_AND_NOTIFY thì điều sau sẽ xảy ra:

  1. Một mục "Tin nhắn" sẽ được thêm vào "mặt sau của thẻ và vé" (còn gọi là Mẫu chi tiết) và một thông báo đẩy sẽ được gửi cho người dùng khi thẻ và vé đã được lưu.
  2. Khi người dùng nhấn vào thông báo, thông báo đó sẽ mở Google Wallet ở mặt trước của thẻ/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 cùng nút "Xem tin nhắn".
  3. Khi nhấp vào chú thích, người dùng sẽ quay lại cuối thẻ, nơi các tin nhắn mới chưa đọc được đánh dấu.

Một số lưu ý khi gửi thư có thông báo cho người dùng

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

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

Khi 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 được thêm vào bằng API AddMessage, bạn sẽ cần cập nhật AddMessageRequest để Message 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 JSON để thêm thông báo và thông báo trong một lớp Thẻ và vé

  …
  "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 JSON để thêm thông báo và thông báo trong Đối tượng thẻ và vé

  …
  "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 tin nhắn và thông báo về 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ệ

Mọi nỗ lực thông báo quá 3 lần sẽ dẫn đến một phản hồi QuotaExceededException . Bạn có thể đặt thêm bất kỳ cập nhật nào cho thẻ và vé bằng cách sử dụng "TEXT" thay vì "TEXT_AND_ tới" như đã thảo luận trong Các bước tích hợp.