プッシュ通知のトリガー

通知の種類

メッセージと通知を追加する

背景

ユーザーがパスを追加した後、パスに関連するメッセージを送信して、パスに関する通知を確実に受け取るようにすることができます。message_type が TEXT_AND_NOTIFY に等しい Add Message API リクエストを使用すると、次のことが発生します。

  1. [メッセージ] アイテムが「パスの裏面」（詳細テンプレート）に追加され、パスが保存されているユーザーにプッシュ通知が送信されます。
  2. ユーザーが通知をタップすると、Google ウォレットが開き、パスの表面（カードビュー）が表示されます。画面上部には、[メッセージを表示] ボタンのあるコールアウトが表示されます。
  3. コールアウトをクリックすると、パスの裏面が表示され、未読の新しいメッセージがハイライト表示されます。

通知付きのメッセージをユーザーに送信する場合の考慮事項

  • メッセージに関連するプッシュ通知を受信するには、パスの通知を有効にする必要があります。
  • メッセージには、ウェブサイトまたはアプリの URI を含めることができます。ハイパーリンクは、パスに関連するウェブサイトやアプリである必要があります。パスに関係のないリンクにユーザーを誘導することは、利用規定違反となります。
  • プッシュ通知をトリガーするメッセージを 24 時間に 3 回まで送信できます。ユーザーに迷惑メールを送信しているとみなされた場合、Google はプッシュ通知の配信割り当てを調整することがあります。
  • ロック画面に表示されるプッシュ通知は、Google ウォレットによって制御されます。
  • UPDATE メソッドまたは PATCH メソッドを使用して、通常のクラスまたはオブジェクト エンドポイントを使用してメッセージデータを編集または削除できます。

統合の手順

AddMessage API を使用して追加された新しいカード発行会社のメッセージをユーザーに通知する場合は、AddMessageRequest を更新して、新しいテキストを含む Message の MessageType が TEXT ではなく TEXT_AND_NOTIFY になるようにする必要があります。

パスクラスにメッセージを追加して通知する 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"
    },
  …

パスクラスのメッセージの追加と通知のレスポンスの例

  // 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_AND_NOTIFY」ではなく「TEXT」を使用して設定できます。