Amazon SNS のモバイルプッシュ通知で有効期限メッセージ属性を使用する

フォーカスモード

Amazon SNS のモバイルプッシュ通知で有効期限メッセージ属性を使用する - Amazon Simple Notification Service

プッシュ通知サービスの TTL メッセージ属性 TTL を決定するための優先順位を使用した TTL の指定 AWS Management Console

Amazon Simple Notification Service (Amazon SNS) では、モバイルプッシュ通知サービスの有効期限 (TTL) メッセージ属性の設定がサポートされています。この属性は、モバイルプッシュ通知サービス (Amazon Device Messaging (ADM)、Firebase Cloud Messaging (FCM、Android への送信時) など) の Amazon SNS メッセージ本文内に TTL を設定する既存の機能に追加されたものです。

TTL メッセージ属性は、メッセージの有効期限メタデータを指定するために使用します。この属性を使用して、Apple Push Notification Service (APNs) や FCM などのプッシュ通知サービスによってエンドポイントにメッセージが配信される時間を指定できます。何らかの理由 (モバイルデバイスがオフになっているなど) で、指定した TTL 内にメッセージが配信されなかった場合、そのメッセージは破棄され、以降その配信は試みられません。メッセージ属性内で TTL を指定するには、、 AWS ソフトウェア開発キット (SDKs) AWS Management Console、またはクエリ API を使用できます。

以下は、 AWS SDKs またはクエリ API の使用時に設定するために使用できるプッシュ通知サービスの TTL メッセージ属性のリストです。

プッシュ通知サービス	TTL メッセージ属性
Amazon Device Messaging (ADM)	`AWS.SNS.MOBILE.ADM.TTL`
Apple Push Notification Service (APNS)	`AWS.SNS.MOBILE.APNS.TTL`
Apple Push Notification Service Sandbox (APNs_SANDBOX)	`AWS.SNS.MOBILE.APNS_SANDBOX.TTL`
Baidu Cloud Push (Baidu)	`AWS.SNS.MOBILE.BAIDU.TTL`
Firebase Cloud Messaging (FCM、Android への送信時)	`AWS.SNS.MOBILE.FCM.TTL`
Windows Push Notification Services (WNS)	`AWS.SNS.MOBILE.WNS.TTL`

各プッシュ通知サービスは TTL を個別に処理します。Amazon SNS では、すべてのプッシュ通知サービスに対する TTL の抽象ビューが提供されるため、TTL の指定がより簡単になります。を使用して TTL AWS Management Console を指定する場合 (秒単位）、TTL 値を 1 回入力するだけで、Amazon SNS はメッセージを発行するときに、選択したプッシュ通知サービスごとに TTL を計算します。

TTL は発行時間を基準にします。特定のプッシュ通知サービスにプッシュ通知メッセージを発行する前に、Amazon SNS はプッシュ通知のドウェル時間 (発行のタイムスタンプからプッシュ通知サービスへの発行直前までの時間) を計算し、残りの TTL をそのプッシュ通知サービスに渡します。TTL がドウェル時間よりも短い場合、Amazon SNS はプッシュ通知メッセージの発行を試みません。

プッシュ通知メッセージに TTL を指定する場合、TTL 値は正の整数でなければなりません。ただし、0 の値がプッシュ通知サービスで固有の意味を持つ場合 (APN や FCM (Android への送信時) など) は除きます。TTL 値を 0 に設定した場合、プッシュ通知サービスに対して 0 に特定の意味がないと、Amazon SNS はメッセージを破棄します。APN を使用した場合に 0 に設定した TTL パラメータの詳細については、バイナリプロバイダー API ドキュメントの表 A-3 リモート通知のアイテム識別子を参照してください。