共用方式為

MailDetailSpam 報告

  • 發行項

MailDetailSpam REST URI 提供有關在電子郵件會被識別為包含垃圾郵件處理郵件時所採取的處理步驟的詳細資訊。可以在要求中指定開始和結束日期/時間的報表。

前次修改時間: 2015年9月17日

適用於: Office 365

REST Uri

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailSpam[?ODATA options]

欄位

您可以指定下列欄位中$select、 $filter及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。

名稱

WCF 類型 *

EDM 類型 *

[以/照] * * 描述

範例值

新增服務版本

Action

string

None 指定

[納入/剔除]如果有任何郵件採取的動作的描述。此欄位可能會是空白的如果則為 null 來執行任何動作。如需有效值巨集指令，請參閱MailFilterList 報告。

SetSpamConfidenceLevel, RejectMessage

2013-V1

Date

System.DateTime

Edm.DateTime

[納入/剔除]日期及時間為垃圾郵件偵測到郵件。

簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間

2013-V1

Direction

string

None 指定

[納入/剔除]會指定郵件是否被傳送到 (Inbound) 或從 (Outbound) 它已偵測到為垃圾郵件時的組織 (英文)。

值為受限於Inbound和Outbound。

2013-V1

Domain

string

未指定

[納入/剔除]已處理的電子郵件的完整的網域名稱。

example.onmicrosoft.com

2013-V1

EndDate

System.DateTime

Edm.DateTime

[In此欄位用來限制在報告期間。使用此欄位$filter查詢選項可設定的結束日期和時間的報表期間。如果您提供EndDate $filter] 選項，您也必須提供StartDate。

簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間

2013-V1

EventType

string

None 指定

[納入/剔除]掃描記錄的事件類型。如需有效EventType值的資訊，請參閱MailFilterList 報告。

SpamContentFiltered, SpamIPBlock

2013-V1

MessageId

string

None 指定

[納入/剔除]提供郵件，如果有一個網際網路MessageID標頭。這個值也可以是明確null。

如果沒有 ID 提供給郵件，報告資料會顯示<d:MessageId m:null="true" /> Atom 和"MessageId":null JSON。

2013-V1

MessageSize

int

Edm.Int64

[納入/剔除]郵件大小 (位元組)。

130840

2013-V1

MessageTraceId

System.Guid

Edm.Guid

[納入/剔除]用來取得的詳細的訊息識別碼傳輸追蹤資訊。內部MessageTraceId欄位的格式應被視為不透明，可能會變更格式。如需郵件追蹤的詳細資訊，請參閱MessageTrace 報告。

ae4ad8f6-7613-411c-e67e-08cfc740629

2013-V1

Organization

string

None 指定

[納入/剔除]處理電子郵件訊息的完整的網域名稱。

example.onmicrosoft.com

2013-V1

RecipientAddress

string

None 指定

[納入/剔除]郵件已傳送給使用者的 SMTP 電子郵件地址。

userone@example.onmicrosoft.com

2013-V1

SenderAddress

string

None 指定

[納入/剔除]使用者郵件的 SMTP 電子郵件地址據稱是已從。寄件者地址通常詐騙的垃圾電子郵件，因為他們未被視為完全可靠。

usertwo@example.onmicrosoft.com

2013-V1

StartDate

System.DateTime

Edm.DateTime

[In此欄位用來限制在報告期間。若要設定的開始日期和時間的報表期間使用$filter查詢選項中的此欄位。如果您提供StartDate$filter ] 選項，您還必須指定與EndDate。

簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間

2013-V1

Subject

string

None 指定

[納入/剔除]如果其中一個已存在的郵件上的郵件主旨行。

Free M0ney WoN!

2013-V1

* WCF 類型參照Visual Studio中建立 Windows Communications Framework (WCF) 服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。

* * [納入/剔除]： 請參閱在輸入參數並報告輸出欄] 區段中。

備註

在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊，請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。

Date欄位表示郵件時Office 365系統會處理與報告中的這些伺服器的時區。

使用 StartDate 和 EndDate

StartDate和EndDate欄位無法提供報表結果中的實用資訊以及一律設為0001-01-01T00:00:00Z報表在輸出中。它們都是要啟用的報告的時間間隔，輕鬆限制，並提供比就是可在 「 每日 」 報表 rlo 的精確度。

例如，錄製每小時為基礎的電子郵件型拒絕服務攻擊時這可以是特別有用。時使用這些欄位，您必須包含StartDate和EndDate欄位$filter ] 選項。兩者都視為選擇性的但如果您提供一個，您必須提供其他。如果查詢中沒有提供 StartDate/EndDate 組的名稱、 預設的報表期間為前兩週。遵循範例區段示範如何使用StartDate和EndDate欄位。

範例

下列範例會示範如何擷取列出的第三個垃圾郵件動作 ($top=3) MailDetailSpam報表期間 5 am 到 6 AM 2013 年 1 月 27 日 ( $filter=選項)。它會傳回僅 [日期、 主旨和 EventType (使用$select=)] 欄位和項目排序反向先後順序 ($orderby)。當使用此查詢樣式限制在報告期間，您必須包含StartDate和EndDate欄位。如果您使用僅有一個，要求將會失敗。如果您省略兩者，報表期間都會預設為前兩週。為避免混淆，分行符號新增至要求和一些 Atom XML 結果已移除從結果。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailSpam?
    $select=Date,Subject,EventType&
    $filter=StartDate%20eq%20datetime'2013-01-27T05:00:00'%20and%20EndDate%20eq%20datetime'2013-01-27T06:00:00'%20&
    $top=3&
    $orderby=Date%20desc&
    $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
    xmlns="http://www.w3.org/2005/Atom"
    xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
    xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://example.onmicrosoft.com/ecp/reportingwebservice/reporting.svc/MailDetailSpam</id>
  <title type="text">MailDetailSpam</title>
  <updated>2013-01-31T08:02:50Z</updated>
  <link rel="self" title="MailDetailSpam" href="MailDetailSpam" />
  <entry>
    <id>https://example.onmicrosoft.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(0)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(0)" />
    <title />
    <updated>2013-01-31T08:02:50Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-27T05:17:43.9408799</d:Date>
        <d:Subject>Space Coast Golfers: Your Weekend Tee Times Have Arrived</d:Subject>
        <d:EventType>SpamContentFiltered</d:EventType>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(1)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(1)" />
    <title />
    <updated>2013-01-31T08:02:50Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-27T05:18:31.7775631</d:Date>
        <d:Subject>Spain Golfers: Your Weekend Tee Times Have Arrived</d:Subject>
        <d:EventType>SpamContentFiltered</d:EventType>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(2)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(2)" />
    <title />
    <updated>2013-01-31T08:02:50Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-27T05:19:43.2337479</d:Date>
        <d:Subject>Ireland Golfers: Your Weekend Tee Times Have Arrived</d:Subject>
        <d:EventType>SpamContentFiltered</d:EventType>
      </m:properties>
    </content>
  </entry>
</feed>

下列 JSON 格式顯示相同的報告結果。

  {
    "d":
      [
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(0)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(0)",
                "type":"TenantReporting.MailDetailSpamReport"
              },
            "Date":"\/Date(1359263863940)\/",
            "Subject":"Space Coast Golfers: Your Weekend Tee Times Have Arrived",
            "EventType":"SpamContentFiltered"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(1)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(1)",
                "type":"TenantReporting.MailDetailSpamReport"
              },
            "Date":"\/Date(1359263911777)\/",
            "Subject":"Spain Golfers: Your Weekend Tee Times Have Arrived",
            "EventType":"SpamContentFiltered"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(2)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(2)",
                "type":"TenantReporting.MailDetailSpamReport"
              },
            "Date":"\/Date(1359263983233)\/",
            "Subject":"Ireland Golfers: Your Weekend Tee Times Have Arrived",
            "EventType":"SpamContentFiltered"
          }
        
      ]
    
  }

下列報告列出的主旨行與 EventType 回報為'SpamContentFiltered'、 Atom 格式的其中的垃圾郵件的所有執行個體的日期。為避免混淆，分行符號新增至要求和一些 Atom XML 結果已移除從結果。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailSpam?
    $select=Date,Subject&
    $filter=EventType%20eq%20'SpamContentFiltered'&
    $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
    xmlns="http://www.w3.org/2005/Atom"
    xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
    xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailSpam</id>
  <title type="text">MailDetailSpam</title>
  <updated>2013-01-31T08:19:24Z</updated>
  <link rel="self" title="MailDetailSpam" href="MailDetailSpam" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(0)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(0)" />
    <title />
    <updated>2013-01-31T08:19:24Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-23T05:07:48.4767902</d:Date>
        <d:Subject>Take a Swing at Seaview Golf Resort - The Bay Course</d:Subject>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(1)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(1)" />
    <title />
    <updated>2013-01-31T08:19:24Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-23T05:16:47.4695631</d:Date>
        <d:Subject>Take a Swing at Highland Park Golf Club</d:Subject>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(2)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(2)" />
    <title />
    <updated>2013-01-31T08:19:24Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-23T05:17:26.039398</d:Date>
        <d:Subject>Take a Swing at El Camaleon Mayakoba</d:Subject>
      </m:properties>
    </content>
  </entry>
 [[ entries removed ]]
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailSpam(102)</id>
    <category term="TenantReporting.MailDetailSpamReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailSpamReport" href="MailDetailSpam(102)" />
    <title />
    <updated>2013-01-31T08:19:24Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-31T06:28:34.2893369</d:Date>
        <d:Subject>Weekend Tee Times for the Italy Area</d:Subject>
      </m:properties>
    </content>
  </entry>
</feed>

輸入參數並報告輸出欄

在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義：

  • 欄位中表格主要用於$filter=、 $orderby=及其他查詢選項限制報表會傳回的項目中的欄位中標示為 [中]。在欄位標示為 [In 包含$select= ] 選項，可以是資料表欄位和其出現在報表項目但他們會包含任何的有用資料。

  • 欄位標記 [納入/剔除] 欄選取範圍 ($select=) 和項目限制 ($filter=和$orderby=) 選項中可用資料表的欄位中。加入時這些欄位之一$select= ] 選項，將會出現在報表項目，且可用時將會包含有用的資料。

相容性

Office 365 service version 2013-V1中已採用 MailDetailSpam 報表。如需版本設定的詳細資訊，請參閱在 「 Office 365 報告 」 web 服務的版本控制。

對應的 PowerShell cmdlet

MailDetailSpam 報表會傳回資訊與Get MailDetailSpamReport Windows PowerShell指令程式相同。

權限

存取從報表的帳戶必須該Office 365組織中有系統管理權限。如果帳戶可以檢視這份報告Office 365控制台中的帳戶已從 REST web 服務擷取資料的權限。這份報告要求使用者指派給 「 僅檢視收件者 」 角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告： 帳務管理員、 全域管理員、 密碼管理員、 服務管理員及使用者管理管理員。

資料精確度、 保存及可用性

這份報告中提供的資訊包含的確切的日期和時間為每個事件。您可以使用任何合適的時段和工期由$filter選項包括 StartDate 和 EndDate 欄位。時間報告以掃描電子郵件伺服器的時區。

這份報告的資訊是可用的一段 7 天或直到取消訂閱。

事件可能最多它們顯示在報表中前 24 小時的延遲。