翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon SES が Amazon SNS に発行するイベントデータのコンテンツ
<a name="event-publishing-retrieving-sns-contents"></a>

Amazon SES は、Amazon Simple Notification Service に E メール送信イベントレコードを JSON 形式で発行します。

これらのすべての通知タイプのレコード例については、「[Amazon SES が Amazon SNS に発行するイベントデータの例](event-publishing-retrieving-sns-examples.md)」を参照してください。

**Topics**
+ [トップレベル JSON オブジェクト](#event-publishing-retrieving-sns-contents-top-level-json-object)
+ [Mail オブジェクト](#event-publishing-retrieving-sns-contents-mail-object)
+ [Bounce オブジェクト](#event-publishing-retrieving-sns-contents-bounce-object)
+ [苦情のオブジェクト](#event-publishing-retrieving-sns-contents-complaint-object)
+ [配信オブジェクト](#event-publishing-retrieving-sns-contents-delivery-object)
+ [Send オブジェクト](#event-publishing-retrieving-sns-contents-send-object)
+ [Reject オブジェクト](#event-publishing-retrieving-sns-contents-reject-object)
+ [Open オブジェクト](#event-publishing-retrieving-sns-contents-open-object)
+ [Click オブジェクト](#event-publishing-retrieving-sns-contents-click-object)
+ [レンダリング失敗オブジェクト](#event-publishing-retrieving-sns-contents-failure-object)
+ [DeliveryDelay オブジェクト](#event-publishing-retrieving-sns-contents-delivery-delay-object)
+ [サブスクリプションオブジェクト](#event-publishing-retrieving-sns-contents-subscription-object)

## トップレベル JSON オブジェクト
<a name="event-publishing-retrieving-sns-contents-top-level-json-object"></a>

メール送信イベントレコードのトップレベル JSON オブジェクトには、以下のフィールドが含まれています。他にどのオブジェクトが存在するのかは、イベントタイプによって決まります。


| フィールド名 | 説明 | 
| --- | --- | 
|  `eventType`  |  イベントのタイプを説明する文字列。可能な値: `Bounce`、`Complaint`、`Delivery`、`Send`、`Reject`、`Open`、`Click`、`Rendering Failure`、`DeliveryDelay`、または `Subscription`。 もし[イベント発行のセットアップ](monitor-sending-using-event-publishing-setup.md)をしなかった場合は、このフィールドは `notificationType` と名付けられます。  | 
|  `mail`  |  イベントを作成した E メールに関する情報を含む JSON オブジェクト。  | 
|  `bounce`  |  このフィールドは、`eventType` が `Bounce` の場合のみ表示されます。このフィールドには、バウンスに関する情報が含まれています。  | 
|  `complaint`  |  このフィールドは、`eventType` が `Complaint` の場合のみ表示されます。このフィールドには、苦情に関する情報が含まれています。  | 
|  `delivery`  |  このフィールドは、`eventType` が `Delivery` の場合のみ表示されます。このフィールドには、配信に関する情報が含まれています。  | 
|  `send`  |  このフィールドは、`eventType` が `Send` の場合のみ表示されます。  | 
|  `reject`  |  このフィールドは、`eventType` が `Reject` の場合のみ表示されます。このフィールドには、拒否に関する情報が含まれています。  | 
|  `open`  |  このフィールドは、`eventType` が `Open` の場合のみ表示されます。このフィールドには、オープンイベントに関する情報が含まれています。  | 
|  `click`  |  このフィールドは、`eventType` が `Click` の場合のみ表示されます。このフィールドには、クリックイベントに関する情報が含まれています。  | 
| `failure` | このフィールドは、`eventType` が `Rendering Failure` の場合のみ表示されます。このフィールドには、レンダリング失敗イベントに関する情報が含まれています。 | 
|  `deliveryDelay`  |  このフィールドは、`eventType` が `DeliveryDelay` の場合のみ表示されます。E メールの遅延配信に関する情報が含まれています。  | 
|  `subscription`  |  このフィールドは、`eventType` が `Subscription` の場合のみ表示されます。このフィールドには、サブスクリプション設定に関する情報が含まれています。  | 

## Mail オブジェクト
<a name="event-publishing-retrieving-sns-contents-mail-object"></a>

各メール送信イベントレコードには、`mail` オブジェクトの元のメールに関する情報が含まれています。`mail` オブジェクトについての情報を含む JSON オブジェクトには次のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `timestamp`  |  メッセージが送信された、ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) の日時。  | 
|  `messageId`  |  Amazon SES がメッセージに割り当てた一意の ID。ユーザーがメッセージを送信すると、Amazon SES がこの値を返します。  このメッセージ ID は Amazon SES によって割り当てられます。元の E メールのメッセージ ID は、`mail` オブジェクトの `headers` および `commonHeaders` フィールドにあります。   | 
|  `source`  |  メッセージの送信元の E メールアドレス (エンベロープ MAIL FROM アドレス)。  | 
|  `sourceArn`  |  E メールの送信に使用された ID の Amazon リソースネーム (ARN)。送信承認の場合、`sourceArn` は、代理送信者が E メールの送信に使用することをアイデンティティ所有者により承認されたアイデンティティの ARN です。送信承認の詳細については、「[E メールの認証方法送信承認の使用](sending-authorization.md)」を参照してください。  | 
|  `sendingAccountId`  |  E メールの送信に使用されたアカウントのアカウント AWS ID。送信承認の場合、`sendingAccountId` は代理送信者のアカウント ID です。  | 
|  `destination`  |  元のメールの受取人の E メールアドレスのリスト。  | 
|  `headersTruncated`  |  通知でヘッダーが切り捨てられたかどうかを示す文字列。切り捨ては、ヘッダーが 10 KB を超える場合に発生します。指定できる値は `true` および `false` です。  | 
|  `headers`  |  E メールの元のヘッダーの一覧。リスト内の各ヘッダーには、`name` フィールドと `value` フィールドがあります。  `headers` フィールド内のメッセージ ID は、Amazon SES に渡した元のメッセージのものです。その後 Amazon SES がメッセージに割り当てるメッセージ ID は、`mail` オブジェクトの `messageId` フィールドのものです。   | 
|  `commonHeaders`  |  E メールの元の一般的に使用されるヘッダーのマッピング。  `commonHeaders` フィールド内のメッセージ ID は、Amazon SES が後で `mail` オブジェクトの `messageId` フィールドでメッセージに割り当てたメッセージ ID です。   | 
|  `tags`  |  E メールに関連付けられたタグのリストです。  | 

## Bounce オブジェクト
<a name="event-publishing-retrieving-sns-contents-bounce-object"></a>

`Bounce` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `bounceType`  |  バウンスのタイプで、Amazon SES によって決定されます。  | 
|  `bounceSubType`  |  バウンスのサブタイプで、Amazon SES によって決定されます。  | 
|  `bouncedRecipients`  |  バウンスとなった元のメールの受取人についての情報を含むリスト。  | 
|  `timestamp`  |  ISP がバウンス通知を送信した、ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) の日時。  | 
|  `feedbackId`  |  バウンスの一意の ID。  | 
|  `reportingMTA`  |  DSN の `Reporting-MTA` フィールドの値。これは、DSN に記述された配信、リレー、またはゲートウェイのオペレーションを試みた MTA (Message Transfer Authority) の値です。  このフィールドは、配信ステータス通知 (DSN) がバウンスにアタッチされている場合にのみ表示されます。   | 

### バウンスとなった受取人
<a name="event-publishing-retrieving-sns-contents-bounced-recipients"></a>

バウンスイベントには、1 人の受信者に関するものと複数の受信者に関するものがあります。`bouncedRecipients` フィールドにはオブジェクトのリストが含まれ (バウンスを作成した E メールアドレスの受信者ごとに 1 つのオブジェクト)、以下のフィールドが含まれています。


| フィールド名 | 説明 | 
| --- | --- | 
|  `emailAddress`  |  受取人の E メールアドレス。DSN が利用できる場合、これが DSN の `Final-Recipient` フィールドの値です。  | 

オプションで、DSN がバウンスに添付されている場合、以下のフィールドも表示される場合があります。


| フィールド名 | 説明 | 
| --- | --- | 
|  `action`  |  DSN の `Action` フィールドの値。このフィールドには、Reporting-MTA により実行された、この受取人に対してメッセージを送信しようとした結果のアクションが示されます。  | 
|  `status`  |  DSN の `Status` フィールドの値。これは、メッセージの配信状態を示す、受取人ごとに個別の、トランスポート独立型ステータスコードです。  | 
|  `diagnosticCode`  |  ステータスコードは、Reporting-MTA により発行されます。これは、DSN の `Diagnostic-Code` フィールドの値です。このフィールドが DSN に存在しない場合もあります (その場合 JSON オブジェクトにも表示されません)。  | 

### バウンスのタイプ
<a name="event-publishing-retrieving-sns-contents-bounce-types"></a>

各バウンスイベントは、以下の表に示すいずれかのタイプになります。

イベント発行システムは、Amazon SES によって再試行されなくなるハードバウンスおよびソフトバウンスのみを発行します。`Permanent` とマークされたバウンスを受信した場合は、対応する E メールアドレスをメーリングリストから削除する必要があります。これらは今後も送信できません。`Transient` バウンスは、メッセージに対してソフトバウンスが複数回発生して Amazon SES が再送を停止した場合に送信されます。最初は `Transient` バウンスとして返されても、将来的には同じアドレスに正常に再送できる場合があります。


| bounceType | bounceSubType | 説明 | 
| --- | --- | --- | 
|  `Undetermined`  |  `Undetermined`  |  Amazon SES はバウンスの理由を特定できませんでした。  | 
|  `Permanent`  |  `General`  |  Amazon SES は、一般的なハードバウンスを受け取りました。このタイプのバウンスを受信した場合は、メーリングリストからこの受信者のメールアドレスを削除する必要があります。  | 
|  `Permanent`  |  `NoEmail`  |  Amazon SES は、送信先の E メールアドレスが存在しないことが原因である永続的なハードバウンスを受け取りました。このタイプのバウンスを受信した場合は、メーリングリストからこの受信者のメールアドレスを削除する必要があります。  | 
|  `Permanent`  |  `Suppressed`  |  Amazon SES は、このアドレスへの送信を抑制しました。このアドレスは無効なアドレスとして最近バウンスとなった履歴があるからです。グローバルサプレッションリストを上書きするには、「[Amazon SES アカウントレベルのサプレッションリストの使用](sending-email-suppression-list.md)」を参照してください。  | 
| Permanent | OnAccountSuppressionList | Amazon SES は、アドレスが[アカウントレベルのサプレッションリスト](sending-email-suppression-list.md)にあるので、このアドレスへの送信を抑制しました。これは、バウンス率のメトリクスに対してはカウントされません。 | 
|  `Transient`  |  `General`  |  Amazon SES は、一般的なバウンスを受け取りました。今後、この受信者に正常に再送できる可能性があります。  | 
|  `Transient`  |  `MailboxFull`  |  Amazon SES は、メールボックスが一杯であることを示すバウンスを受け取りました。今後、この受信者に正常に再送できる可能性があります。  | 
|  `Transient`  |  `MessageTooLarge`  |  Amazon SES は、メッセージサイズが大きすぎることを示すバウンスを受け取りました。メッセージサイズを小さくすることで、この受信者に正常に再送できる可能性があります。  | 
|  `Transient`  |  `CustomTimeoutExceeded`  |  Amazon SES は、E メール送信者が指定した時間内での E メールの配信を正常に完了できませんでした。*(バウンスメッセージは、定義済みの TTL 内で配信試行が失敗した原因の可能性を指定します)。*  | 
|  `Transient`  |  `ContentRejected`  |  Amazon SES は、コンテンツが拒否されたことを示すバウンスを受け取りました。メッセージのコンテンツを変更することで、この受信者に正常に再送できる可能性があります。  | 
|  `Transient`  |  `AttachmentRejected`  |  Amazon SES は、添付ファイルが拒否されたことを示すバウンスを受け取りました。添付ファイルを削除または変更することで、この受信者に正常に再送できる可能性があります。  | 

## 苦情のオブジェクト
<a name="event-publishing-retrieving-sns-contents-complaint-object"></a>

`Complaint` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `complainedRecipients`  |  苦情を送信した可能性がある受取人に関する情報を含むリスト。  | 
|  `timestamp`  |  ISP が苦情通知を送信した、ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) の日時。  | 
|  `feedbackId`  |  苦情の一意の ID。  | 
|  `complaintSubType`  |  苦情のサブタイプで、Amazon SES によって決定されます。  | 

また、フィードバックレポートが苦情に添付されている場合、以下のフィールドが示される場合があります。


| フィールド名 | 説明 | 
| --- | --- | 
|  `userAgent`  |  フィードバックレポートの `User-Agent` フィールドの値。これは、レポートを生成したシステムの名前とバージョンを示します。  | 
|  `complaintFeedbackType`  |  ISP から受け取ったフィードバックレポートの `Feedback-Type` フィールドの値。これには、フィードバックのタイプが含まれます。  | 
|  `arrivalDate`  |  ISO 8601 形式のフィードバックレポートの `Arrival-Date` または `Received-Date` フィールドの値 (*YYYY-MM-DDThh:mm:ss.sZ*)。このフィールドがレポートにない場合もあります (その場合、JSON オブジェクトにも表示されません)。  | 

### 苦情を申告した受取人
<a name="event-publishing-retrieving-sns-contents-complained-recipients"></a>

`complainedRecipients` フィールドには、苦情の送信元と思われる受信者のリストが含まれます。

**重要**  
ほとんどの ISP は、苦情を送信した受信者の E メールアドレスを編集します。このため、`complainedRecipients` フィールドには、苦情通知を発行したドメインにアドレスが含まれていて、E メールが送信された全員のリストが含まれます。

このリストの JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `emailAddress`  |  受取人の E メールアドレス。  | 

### 苦情のタイプ
<a name="event-publishing-retrieving-sns-contents-complaint-types"></a>

`complaintFeedbackType` フィールドには以下の苦情のタイプが示されます ([Internet Assigned Numbers Authority ウェブサイト](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2) に基づいて、報告する ISP により割り当てられます)。


| フィールド名 | 説明 | 
| --- | --- | 
|  `abuse`  |  迷惑メールまたはその他のメール不正使用。  | 
|  `auth-failure`  |  E メールの認証障害レポート  | 
|  `fraud`  |  なんらかの詐欺またはフィッシング行為を示します。  | 
|  `not-spam`  |  レポートの提供者がこのメッセージをスパムではないと見なしていることを示します。このタイプは、誤ってスパムとしてタグ付けまたは分類されたメッセージを修正するために使用される場合があります。  | 
|  `other`  |  その他の登録されたタイプに該当しないフィードバックを示します。  | 
|  `virus`  |  元のメッセージでウイルスが見つかったことを示します。  | 

### 苦情のサブタイプ
<a name="event-publishing-retrieving-sns-contents-complaint-subtypes"></a>

`complaintSubType` フィールドの値は、null または `OnAccountSuppressionList` のいずれかになります。値が `OnAccountSuppressionList` の場合、Amazon SES はメッセージを受け入れますが、[アカウントレベルのサプレッションリスト](sending-email-suppression-list.md)に含まれているため、送信を試みません。

## 配信オブジェクト
<a name="event-publishing-retrieving-sns-contents-delivery-object"></a>

`Delivery` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `timestamp`  |  Amazon SES が受信者のメールサーバーにメールを配信した、ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) の日時。  | 
|  `processingTimeMillis`  |  Amazon SES で送信者からリクエストを受理して、Amazon SES が受取人のメールサーバーにメッセージを渡すまでのミリ秒単位の時間。  | 
|  `recipients`  |  配信イベントの適用対象となる受信者のリスト。  | 
|  `smtpResponse`  |  Amazon SES から E メールを受け取ったリモート ISP による SMTP 応答メッセージ。このメッセージは、E メール、受信メールサーバー、または受信する ISP によって異なります。  | 
|  `reportingMTA`  |  メールを送信する Amazon SES メールサーバーのホスト名。  | 
|  `remoteMtaIp`  |  Amazon SES が E メールを配信した先の MTA の IP アドレス。  | 

## Send オブジェクト
<a name="event-publishing-retrieving-sns-contents-send-object"></a>

`send` イベントに関する情報を含む JSON オブジェクトは常に空です。

## Reject オブジェクト
<a name="event-publishing-retrieving-sns-contents-reject-object"></a>

`Reject` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `reason`  |  メールが拒否された理由。このフィールドの唯一の値は `Bad content` です。E メール内のウイルスを Amazon SES で検出したことを意味します。メッセージが拒否されると、Amazon SES はメッセージの処理を停止し、そのメッセージを受信者のメールサーバーに配信しようとしません。  | 

## Open オブジェクト
<a name="event-publishing-retrieving-sns-contents-open-object"></a>

`Open` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `ipAddress`  |  受信側の IP アドレス  | 
|  `timestamp`  |  ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) で表示された、オープンイベントが発生日時。  | 
|  `userAgent`  |  受取人がメールを開くために使用したしたデバイスまたは E メールクライアントのユーザーエージェント。  | 

## Click オブジェクト
<a name="event-publishing-retrieving-sns-contents-click-object"></a>

`Click` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `ipAddress`  |  受信側の IP アドレス  | 
|  `timestamp`  |  ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) で表示された、クリックイベントが発生日時。  | 
|  `userAgent`  |  受信者が E メールのリンクをクリックするために使用したクライアントのユーザーエージェント。  | 
|  `link`  |  受取人がクリックしたリンクの URL。  | 
|  `linkTags`  |  `ses:tags` 属性を使用してリンクに追加されたタグのリスト。メール内のリンクにタグを追加する方法については、「[Amazon SES E メール送信メトリクスに関するよくある質問](faqs-metrics.md)」の「[Q5. リンクに一意の識別子をタグ付けできますか?](faqs-metrics.md#sending-metric-faqs-clicks-q5)」を参照してください。  | 

## レンダリング失敗オブジェクト
<a name="event-publishing-retrieving-sns-contents-failure-object"></a>

`Rendering Failure` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `templateName`  |  E メールの送信に使用されるテンプレートの名前。  | 
|  `errorMessage`  |  レンダリング失敗に関する詳細情報を提供するメッセージ。  | 

## DeliveryDelay オブジェクト
<a name="event-publishing-retrieving-sns-contents-delivery-delay-object"></a>

`DeliveryDelay` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `delayType`  |  遅延のタイプ。想定される値は次のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ses/latest/dg/event-publishing-retrieving-sns-contents.html)  | 
|  `delayedRecipients`  |  E メールの受取人に関する情報を含むオブジェクト。  | 
|  `expirationTime`  |  Amazon SES がメッセージの配信を停止する日時。この値は ISO 8601 形式で表示されます。  | 
|  `reportingMTA`  |  遅延を報告したメッセージ転送エージェント (MTA) の IP アドレス。  | 
|  `timestamp`  |  遅延が発生した日時。ISO 8601 形式で表示されます。  | 

### 遅延受取人
<a name="event-publishing-retrieving-sns-contents-delivery-delay-object-recipients"></a>

`delayedRecipients` オブジェクトには、以下の値が含まれています。


| フィールド名 | 説明 | 
| --- | --- | 
|  `emailAddress`  |  メッセージの配信が遅れる原因となった E メールアドレス。  | 
|  `status`  |  配信遅延に関連付けられた SMTP ステータスコード。  | 
|  `diagnosticCode`  |  受信側メッセージ転送エージェント (MTA) によって提供される診断コード。  | 

## サブスクリプションオブジェクト
<a name="event-publishing-retrieving-sns-contents-subscription-object"></a>

`Subscription` イベントに関する情報を含む JSON オブジェクトには以下のフィールドが含まれます。


| フィールド名 | 説明 | 
| --- | --- | 
|  `contactList`  |  連絡先が含まれているリストの名前。  | 
|  `timestamp`  |  ISP がサブスクリプション通知を送信した、ISO8601 形式 (*YYYY-MM-DDThh:mm:ss.sZ*) の日時。  | 
|  `source`  |  メッセージの送信元の E メールアドレス (エンベロープ MAIL FROM アドレス)。  | 
|  `newTopicPreferences`  |  連絡先リスト内のすべてのトピックのサブスクリプションステータスを指定する JSON データ構造 (マップ) です。変更後のステータス (連絡先がサブスクライブ済み、またはサブスクライブ解除) を示します。  | 
|  `oldTopicPreferences`  |  連絡先リスト内のすべてのトピックのサブスクリプションステータスを指定する JSON データ構造 (マップ)。変更前のステータス (連絡先がサブスクライブ済みまたは未サブスクライブ解除) を示します。  | 

### 新旧トピックの設定
<a name="event-publishing-retrieving-sns-contents-subscription-object-topic-preferences"></a>

`newTopicPreferences` および `oldTopicPreferences` オブジェクトには、以下の値が含まれています。


| フィールド名 | 説明 | 
| --- | --- | 
|  `unsubscribeAll`  |  連絡先リストのすべてのトピックから、連絡先がサブスクライブ解除されているかどうかを指定します。  | 
|  `topicSubscriptionStatus`  |  `topicName` フィールドにトピックのサブスクリプションステータスを指定します。ステータスは、指定されたイベントタイプについて SES から通知を受信するために現在サブスクライブしているかを示します。`subscriptionStatus` フィールドで想定される値は、**OptIn** (サブスクライブ済み) または **OptOut** (サブスクリプションを解除) です。  | 
|  `topicDefaultSubscriptionStatus`  |  イベント送信先に追加された新しいトピックをデフォルトでサブスクライブするか、サブスクライブ解除するかを決定する `topicName` フィールドで、トピックのデフォルトのサブスクリプションステータスを指定します。`subscriptionStatus` フィールドで想定される値は、**OptIn** (デフォルトでサブスクライブ済み) または **OptOut** (デフォルトでサブスクリプションを解除) です。  |