觸發推播通知

通知類別

新增訊息和通知

背景

使用者新增票證後，您可能會想傳送有關 並確保他們收到通知使用 新增訊息 API message_type 等於 TEXT_AND_NOTIFY 會發生下列情況：

  1. 「訊息」 這樣就會新增至「票證背面」(又稱為詳細資料 範本)，並且將推播通知傳送給已儲存票證的使用者。
  2. 使用者輕觸通知後，系統隨即在前方開啟 Google 錢包 票證 (又稱為「資訊卡」檢視)，使用者就會在頁面頂端看到摘要 螢幕上顯示「查看訊息」按鈕。
  3. 使用者點選摘要後會返回票證的背面 未讀郵件會醒目顯示。

傳送通知給使用者時應注意的事項

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

整合步驟

您想透過 AddMessage API，您將需要更新 AddMessageRequest 系統會將訊息 其內含您的新文字具有 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"
    },
  …

在「Pass 物件」中新增訊息和通知的 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」，詳情請參閱「整合 步驟。