Отчет о MailDetailSpam

MailDetailSpam REST URI предоставляет подробные сведения о действиях обработки на сообщения электронной почты, определенные как содержащий нежелательной почты при обработке сообщений. Начальная и конечная дата и время отчета можно указать в запросе.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Коды URI REST

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

Поля

В $select, $filter и $orderby параметры запроса ODATA2 можно указать следующие поля. Если указан параметр $select не возвращаются все поля.

* Тип WCF относится к типу данных .NET Framework, назначенный в поле при создании ссылки на службу Windows Communications Framework (WCF) в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.

** [In/Out]: видеть входные параметры и сообщить о раздел столбцы выходные данные.

Замечания

Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.

Поле Date указывает, когда сообщения обрабатывались системой Office 365 и сообщает в часовом поясе из этих серверов.

С помощью StartDate и EndDate

Поля StartDate и EndDate не получать полезную информацию в отчет о результатах и всегда значение 0001-01-01T00:00:00Z в выходные данные отчета. Они предназначены для включить простой ограничение отчетов временной интервал, а также предоставлять большая точность не будет доступен в отчете «день».

Это может быть особенно полезны, например, при записи на основе электронной почты атак типа "отказ в обслуживании" на основе каждый час. При использовании этих полей, необходимо включить поля StartDate и EndDate в параметре $filter . Они оба считаются необязательные, но если один, которые необходимо указать другое. Если пара StartDate и EndDate не указан в запросе, отчетного периода времени по умолчанию — это предыдущие две недели. Ниже разделе примерах показано, как использовать поля StartDate и EndDate .

Примеры

Следующем примере показано, как получить отчет MailDetailSpam первого действия сообщений трех нежелательной почты ($top=3) во время период от 5 AM до 6: 00 27 января 2013 г. ( $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>

Входные параметры и сообщить о выходных столбцов

[In/Out] индикаторов в таблице полей имеют следующие значения:

• Поля, отмеченные [In] в поля в таблице в основном предназначены для использования в $filter=, $orderby= и другие параметры запроса, ограничивающие вводимых данных в отчете. Поля, отмеченные [In] в поля в таблице может быть включен параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.

• Поля, отмеченные [In/Out] в поля, которые в таблице можно использовать в выделенный фрагмент столбца ($select=) и параметры ($filter= и $orderby=) ограничение записей. При включении одно из этих полей в параметре $select= , они будут отображаться в отчет операции и будет содержать полезные данные, если она доступна.

Совместимость

Отчет о MailDetailSpam была введена в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями можно Управление версиями в веб-службе отчетов Office 365.

Соответствующий командлеты PowerShell

Отчет о MailDetailSpam возвращает те же данные в командлет Get-MailDetailSpamReportWindows PowerShell. 

Разрешения

Учетная запись для доступа к отчетов из требуются права администратора в организации, Office 365. Если учетная запись может просмотреть этот отчет в панели управления Office 365, учетная запись имеет разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями.

Степень детализации данных, сохранение состояния и доступности

Сведения, доступные в этом отчете содержится точную дату и время для каждого события. Можно использовать любой подходящего периода времени и длительность, включая поля StartDate и EndDate в параметре $filter . Время отображается в часовом поясе сервера сканирования для сообщения электронной почты.

Сведения для этого отчета можно найти в течение 7 дней, или до отмены подписки.

События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.