本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 用於 Amazon SES 電子郵件接收的通知內容
<a name="receiving-email-notifications-contents"></a>

所有電子郵件接收的通知，都會以 JavaScript 物件標記法 (JSON) 格式發佈到 Amazon Simple Notification Service (Amazon SNS) 主題。

如需範例通知，請參閱 [通知範例](receiving-email-notifications-examples.md)。

**Contents**
+ [最上層 JSON 物件](#receiving-email-notifications-contents-top-level-json-object)
+ [接收物件](#receiving-email-notifications-contents-receipt-object)
  + [動作物件](#receiving-email-notifications-contents-action-object)
  + [dkimVerdict 物件](#receiving-email-notifications-contents-dkimverdict-object)
  + [dmarcVerdict 物件](#receiving-email-notifications-contents-dmarcverdict-object)
  + [spamVerdict 物件](#receiving-email-notifications-contents-spamverdict-object)
  + [spfVerdict 物件](#receiving-email-notifications-contents-spfverdict-object)
  + [virusVerdict 物件](#receiving-email-notifications-contents-virusverdict-object)
+ [郵件物件](#receiving-email-notifications-contents-mail-object)
  + [commonHeaders 物件](#receiving-email-notifications-contents-mail-object-commonHeaders)

## 最上層 JSON 物件
<a name="receiving-email-notifications-contents-top-level-json-object"></a>

最上層 JSON 物件包含下列欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  notificationType  |  通知類型。針對這一類通知，值一律為 `Received`。  | 
|  [`receipt`](#receiving-email-notifications-contents-receipt-object)  |  包含有關電子郵件傳遞資訊的物件。  | 
|  [`mail`](#receiving-email-notifications-contents-mail-object)  |  包含與通知建立關聯之電子郵件資訊的物件。  | 
|  content  |  包含原始、未修改的電子郵件之字串，通常是以多用途網際網路郵件延伸 (MIME) 格式顯示。如需 MIME 格式的詳細資訊，請參閱 [RFC 2045](https://tools.ietf.org/html/rfc2045)。  此欄位只有在通知由 SNS 動作觸發時才會顯示。由所有其他動作觸發的通知不會包含此欄位。   | 

## 接收物件
<a name="receiving-email-notifications-contents-receipt-object"></a>

`receipt` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  [`action`](#receiving-email-notifications-contents-action-object)  |  封裝關於執行的動作之資訊的物件。如需可能值的清單，請參閱 [動作物件](#receiving-email-notifications-contents-action-object)。  | 
|  [`dkimVerdict`](#receiving-email-notifications-contents-dkimverdict-object)  |  指出網域金鑰識別郵件 (DKIM) 檢查是否通過的物件。如需可能值的清單，請參閱 [dkimVerdict 物件](#receiving-email-notifications-contents-dkimverdict-object)。  | 
| dmarcPolicy | 指出傳送網域的網域型訊息驗證、回報與遵循 (DMARC) 設定。訊息未通過 DMARC 驗證時，此欄位才會出現。 此欄位可能的值為：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/ses/latest/dg/receiving-email-notifications-contents.html) | 
| [`dmarcVerdict`](#receiving-email-notifications-contents-dmarcverdict-object) | 指出是否通過網域型訊息驗證、回報與遵循 (DMARC) 檢查之物件。如需可能值的清單，請參閱 [dmarcVerdict 物件](#receiving-email-notifications-contents-dmarcverdict-object)。 | 
|  processingTimeMillis  |  此字串指出從 Amazon SES 收到訊息到觸發動作的期間範圍，單位為毫秒。  | 
|  recipients  |  由作用中[接收規則](receiving-email-receipt-rules-console-walkthrough.md)匹配的收件人 (特別是信封收件人地址)。此處列出的地址可能與 `destination` 中的 [郵件物件](#receiving-email-notifications-contents-mail-object) 欄位列出之地址不同。  | 
|  [`spamVerdict`](#receiving-email-notifications-contents-spamverdict-object)  |  指出訊息是否為垃圾郵件的物件。如需可能值的清單，請參閱 [spamVerdict 物件](#receiving-email-notifications-contents-spamverdict-object)。  | 
|  [`spfVerdict`](#receiving-email-notifications-contents-spfverdict-object)  |  指出寄件者政策架構 (SPF) 檢查是否通過的物件。如需可能值的清單，請參閱 [spfVerdict 物件](#receiving-email-notifications-contents-spfverdict-object)。  | 
|  timestamp  |  此字串以 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 格式顯示，指出動作觸發的日期與時間。  | 
|  [virusVerdict](#receiving-email-notifications-contents-virusverdict-object)  |  指出訊息是否包含病毒的物件。如需可能值的清單，請參閱 [virusVerdict 物件](#receiving-email-notifications-contents-virusverdict-object)。  | 

### 動作物件
<a name="receiving-email-notifications-contents-action-object"></a>

`action` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  type  |  表示執行的動作類型之字串。可能值為 `S3`、`SNS`、`Bounce`、`Lambda`、`Stop` 以及 `WorkMail`。  | 
|  topicArn  |  此字串中包含 Amazon SNS 主題的 Amazon Resource Name (ARN)，該主題為通知發佈的位置。  | 
|  bucketName  |  此字串中包含 Amazon S3 儲存貯體的名稱，該儲存貯體為訊息發佈的位置。只會為 S3 動作類型顯示。  | 
|  objectKey  |  此字串中包含可唯一識別 Amazon S3 儲存貯體中電子郵件的名稱。這與 `messageId` 中的 [郵件物件](#receiving-email-notifications-contents-mail-object) 相同。只會為 S3 動作類型顯示。  | 
|  smtpReplyCode  |  包含 SMTP 回覆程式碼的字串，如 [RFC 5321](https://tools.ietf.org/html/rfc5321) 中所定義。只會為退信動作類型顯示。  | 
|  statusCode  |  包含 SMTP 強化狀態程式碼的字串，如 [RFC 3463](https://tools.ietf.org/html/rfc3463) 中所定義。只會為退信動作類型顯示。  | 
|  message  |  包含人物的字串 - 可讀文字，包含在退信訊息中。只會為退信動作類型顯示。  | 
|  sender  |  其中包含的遭退信的電子郵件之寄件者電子郵件的地址字串。此為送出退信訊息的地址。只會為退信動作類型顯示。  | 
|  functionArn  |  此字串中包含被觸發的 Lambda 函數之 ARN。只會為 Lambda 動作類型顯示。  | 
|  invocationType  |  此字串中包含 Lambda 函數的叫用類型。可能值為 `RequestResponse` 和 `Event`。只會為 Lambda 動作類型顯示。  | 
|  organizationArn  |  其中包含 Amazon WorkMail 組織 ARN 的字串。只會為 WorkMail 動作類型顯示。  | 

### dkimVerdict 物件
<a name="receiving-email-notifications-contents-dkimverdict-object"></a>

`dkimVerdict` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  status  |  包含 DKIM verdict 的字串。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/ses/latest/dg/receiving-email-notifications-contents.html)  | 

### dmarcVerdict 物件
<a name="receiving-email-notifications-contents-dmarcverdict-object"></a>

`dmarcVerdict` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  status  |  包含 DMARC verdict 的字串。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/ses/latest/dg/receiving-email-notifications-contents.html)  | 

### spamVerdict 物件
<a name="receiving-email-notifications-contents-spamverdict-object"></a>

`spamVerdict` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  status  |  其中包含垃圾郵件掃描結果的字串。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/ses/latest/dg/receiving-email-notifications-contents.html)  | 

### spfVerdict 物件
<a name="receiving-email-notifications-contents-spfverdict-object"></a>

`spfVerdict` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  status  |  包含 SPF verdict 的字串。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/ses/latest/dg/receiving-email-notifications-contents.html)  | 

### virusVerdict 物件
<a name="receiving-email-notifications-contents-virusverdict-object"></a>

`virusVerdict` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|  status  |  其中包含病毒掃描結果的字串。可能值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/ses/latest/dg/receiving-email-notifications-contents.html)  | 

## 郵件物件
<a name="receiving-email-notifications-contents-mail-object"></a>

`mail` 物件包含以下欄位。


| 欄位名稱 | Description | 
| --- | --- | 
|   destination  |  來自傳入郵件的 MIME 標題之所有收件人地址的完整清單 (包括「收件人：」與「副本：」收件人)。  | 
|  messageId  |  此字串中包含 Amazon SES 指派給電子郵件的唯一 ID。如果電子郵件是遞送至 Amazon S3，訊息 ID 同時也是用來將訊息寫入 Amazon S3 儲存貯體的 Amazon S3 物件金鑰。  | 
|  source  |  包含寄出電子郵件的電子郵件地址字串 (特別是信封的寄件人地址)。  | 
|  timestamp  |  其中包含收到電子郵件時間的字串，以 ISO8601 格式顯示。  | 
|  headers  |  Amazon SES 標頭和您的自訂標頭。每個標頭包含以下欄位：`name` 和 `value`。  | 
|  [`commonHeaders`](#receiving-email-notifications-contents-mail-object-commonHeaders)  |  所有電子郵件常用的標頭。每個標頭包含以下欄位：`name` 和 `value`。  | 
|  headersTruncated  |  此字串說明通知中的標頭是否被截斷，會在標頭大於 10 KB 時顯示。可能值為 `true` 和 `false`。  | 

### commonHeaders 物件
<a name="receiving-email-notifications-contents-mail-object-commonHeaders"></a>

`commonHeaders` 物件可具有下表所示的欄位。此物件中存在的欄位，取決於傳入電子郵件中存在的欄位。


| 欄位名稱 | Description | 
| --- | --- | 
| messageId | 原始訊息的 ID。 | 
| date | Amazon SES 收到訊息的日期和時間。 | 
| to | 電子郵件的 To 標頭。 | 
| cc | 電子郵件的 CC 標頭。 | 
| bcc | 電子郵件的 BCC 標頭。 | 
| from | 電子郵件的 From 標頭。 | 
| sender | 電子郵件的 Sender 標頭。 | 
| returnPath | 電子郵件的 Return-Path 標頭。 | 
| replyTo | 電子郵件的 Reply-To 標頭。 | 
| subject | 電子郵件的 Subject 標頭。 |