觸發推播通知

通知類別

新增訊息並通知

背景

在使用者新增票證後，建議您傳送與票證相關的訊息，並確保他們收到相關通知。使用 message_type 等於 TEXT_AND_NOTIFY 的 Add Message API 要求會發生以下情況：

  1. 「Message」項目會新增至「票證背面」(又稱詳細資料範本)，並在儲存票證後向使用者傳送推播通知。
  2. 使用者輕觸通知後，會開啟票證正面 (又稱為「卡片檢視」) 的 Google 錢包，且畫面頂端會顯示摘要和「查看訊息」按鈕。
  3. 按一下摘要後，系統會將使用者導向票證背面，其中醒目顯示新的未讀訊息。

向使用者傳送通知訊息時的注意事項

  • 使用者必須啟用通知，票證才能收到與訊息相關的推播通知。
  • 訊息可能包含網站或應用程式的 URI，超連結必須是與票證相關的網站或應用程式。將使用者帶往與票證無關的連結，是違反《使用限制政策》的行為。
  • 您在 24 小時內最多可以傳送 3 則觸發推播通知的訊息。如果 Google 認為您將向使用者發送垃圾內容，可能會限制推播通知傳送配額。
  • 使用者螢幕鎖定畫面上的推播通知是由 Google 錢包控制。
  • 您可以透過 UPDATE 或 PATCH 方法，透過一般類別或物件端點編輯或移除訊息資料。

整合步驟

如要在使用 AddMessage API 新增核發者訊息時通知使用者，您必須更新 AddMessageRequest，讓包含新文字的 Message 採用 MessageType TEXT_AND_NOTIFY，而非 TEXT。

範例：在票證類別中新增訊息並通知的 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"
    },
  …

範例：在票證物件中新增訊息並通知的 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"
    },
  …

範例 Response - 新增訊息並通知票證類別

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

例外狀況處理

嘗試通知超過 3 次時，都會產生 QuotaExceededException 回應。您可以按照整合步驟中的討論，使用「TEXT」設定票證的進一步更新，而非「TEXT_AND_NOTIFY」。