通知の種類
メッセージを追加して通知
背景
ユーザーがパスを追加したら、そのパスに関連するメッセージを送信し、そのことが通知されるようにすることをおすすめします。TEXT_AND_NOTIFY と等しい message_type を指定して Add Message API リクエストを使用すると、次のようになります。
- 「メッセージ」項目が「パスの裏面」（別名「詳細テンプレート」）に追加され、パスが保存されたユーザーにプッシュ通知が送信されます。
- ユーザーが通知をタップすると、Google ウォレットが開き、パスの前面（カードビュー）が表示され、画面の上部に [メッセージを表示] ボタンを含むコールアウトが表示されます。
- ユーザーがコールアウトをクリックすると、パスの背後に移動し、新しい未読メッセージがハイライト表示されます。
通知を含むメッセージを送信する際の考慮事項
- メッセージに関連するプッシュ通知を受信するには、パスの通知を有効にする必要があります。
- メッセージには、ウェブサイトまたはアプリの URI が含まれている場合があります。ハイパーリンクは、パスに関連するウェブサイトまたはアプリである必要があります。パスに関係のないリンクにユーザーを誘導することは、利用規定違反になります。
- プッシュ通知をトリガーするメッセージは 24 時間で最大 3 件送信できます。ユーザーにスパム行為をしていると判断した場合、Google はプッシュ通知の配信割り当てを抑制することがあります。
- ロック画面に表示されるプッシュ通知は Google ウォレットによって管理されます。
- UPDATE メソッドまたは PATCH メソッドを使用して、通常のクラスまたはオブジェクト エンドポイントを使用してメッセージ データを編集または削除できます。
統合の手順
AddMessage API を使用して追加された新しい発行者のメッセージをユーザーに通知する場合は、新しいテキストを含む Message が TEXT ではなく MessageType TEXT_AND_NOTIFY になるように、AddMessageRequest を更新する必要があります。
メッセージを追加してパスクラスで通知する 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」を使用して設定できます。