Операция MarkAsJunk

  • Статья

Найдите сведения об операции EWS MarkAsJunk .

Операция MarkAsJunk добавляет и удаляет пользователей из списка заблокированных сообщений электронной почты и перемещает сообщения электронной почты в папку Нежелательная Email.

Эта операция появилась в Exchange Server 2013.

Использование операции MarkAsJunk

Операция MarkAsJunk содержит два логических параметра, указывающих, следует ли добавить отправителя электронной почты в список заблокированных отправителей и переместить целевое сообщение электронной почты в папку нежелательной Email по умолчанию или папку "Входящие". Действия определяются значениями атрибутов IsJunk и MoveItem . Ниже приведены возможные действия, основанные на сочетаниях значений для атрибутов IsJunk и MoveItem .

  • Если для атрибута IsJunk задано значение true, а для атрибута MoveItem задано значение true, отправитель целевого сообщения электронной почты добавляется в список заблокированных отправителей, а сообщение перемещается в папку Нежелательная почта.

  • Если для атрибута IsJunk задано значение true, а для атрибута MoveItem задано значение false, отправитель целевого сообщения электронной почты добавляется в список заблокированных отправителей и сообщение электронной почты не перемещается из папки.

  • Если атрибут IsJunk имеет значение false, а атрибут MoveItem имеет значение true, отправитель целевого сообщения электронной почты удаляется из списка заблокированных отправителей, а сообщение перемещается в папку "Входящие".

  • Если для атрибута IsJunk задано значение false, а для атрибута MoveItem — значение false, отправитель целевого сообщения электронной почты удаляется из списка заблокированных отправителей и сообщение электронной почты не перемещается из папки.

Важно!

Содержимое списка заблокированных отправителей невозможно обнаружить из EWS. Если отправитель добавлен в список заблокированных отправителей, необходимо сохранить копию сообщения электронной почты, отправленного заблокированным отправителем, чтобы разблокировать его в будущем.

Заголовки SOAP операции MarkAsJunk

Операция MarkAsJunk может использовать заголовки SOAP, перечисленные в следующей таблице.

Имя заголовка Элемент Описание
Олицетворения
ExchangeImpersonation
Определяет пользователя, которого олицетворяет клиентское приложение. Этот заголовок применим к запросу.
MailboxCulture
MailboxCulture
Определяет язык и региональные параметры, определенные в RFC 3066 "Теги для идентификации языков", которые будут использоваться для доступа к почтовому ящику. Этот заголовок применим к запросу.
RequestVersion
RequestServerVersion
Определяет версию схемы для запроса операции. Этот заголовок применим к запросу.
ServerVersion
ServerVersionInfo
Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу.

Пример запроса на операцию MarkAsJunk: добавление отправителя в список заблокированных отправителей

В следующем примере запроса на операцию MarkAsJunk показано, как добавить отправителя сообщения в список заблокированных отправителей и переместить его в папку нежелательной почты. Операция MarkAsJunk принимает уникальный идентификатор сообщения электронной почты, чтобы определить адрес электронной почты, который используется для ссылки на отправителя, добавленного в список заблокированных отправителей.

Примечание.

Все идентификаторы элементов и ключи изменения в этой статье сокращены для сохранения удобочитаемости.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <t:RequestServerVersion Version="Exchange2013" />
    </soap:Header>
    <soap:Body>
        <m:MarkAsJunk IsJunk="true" MoveItem="true">
            <m:ItemIds>
                <t:ItemId Id="AAMkAD=" ChangeKey="CQAAABYA" />
            </m:ItemIds>
        </m:MarkAsJunk>
    </soap:Body>
</soap:Envelope>

Текст SOAP запроса содержит следующие элементы:

Успешный ответ на операцию MarkAsJunk

В следующем примере показан успешный ответ на запрос операции MarkAsJunk для добавления отправителя в список заблокированных отправителей и перемещения сообщения электронной почты в папку Нежелательная Email.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <h:ServerVersionInfo MajorVersion="15" 
                             MinorVersion="0" 
                             MajorBuildNumber="545" 
                             MinorBuildNumber="11" 
                             Version="Exchange2013" 
                             xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
    </s:Header>
    <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
            xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <m:MarkAsJunkResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                              xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
           <m:ResponseMessages>
               <m:MarkAsJunkResponseMessage ResponseClass="Success">
                  <m:ResponseCode>NoError</m:ResponseCode>
                 <m:MovedItemId Id="AAMkAD=" ChangeKey="CQAAABYu" />
               </m:MarkAsJunkResponseMessage>
           </m:ResponseMessages>
        </m:MarkAsJunkResponse>
    </s:Body>
</s:Envelope>

Текст SOAP ответа содержит следующие элементы:

Пример запроса на операцию MarkAsJunk: удаление отправителя из списка заблокированных отправителей

В следующем примере запроса на операцию MarkAsJunk показано, как удалить отправителя сообщения из списка заблокированных отправителей и переместить его в папку "Входящие". Чтобы удалить отправителя из списка заблокированных отправителей, необходимо сохранить сообщение электронной почты, отправленное заблокированным отправителем. Адрес электронной почты отправителя связан с сообщениями электронной почты, отправленными отправителем. Удаление отправителя из списка заблокированных отправителей не будет выполнено, если в почтовом ящике пользователя больше нет ссылочного сообщения электронной почты. Идентификатор элемента, используемый для связи сообщения электронной почты с отправителем, должен быть связан с элементом, который существует в почтовом ящике Exchange. Рекомендуется создать скрытую папку для хранения элементов, отправленных ранее заблокированными отправителями, чтобы их можно было разблокировать из клиентского приложения. Если элемент был удален из почтового ящика Exchange, администратор должен использовать консоль управления Exchange для доступа к списку заблокированных отправителей, чтобы удалить отправителя из списка. Сведения о том, как разблокировать пользователя с помощью консоли управления Exchange, см. в статье Настройка параметров безопасных отправителей и заблокированных отправителей в Office 365.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
    </soap:Header>
    <soap:Body>
      <m:MarkAsJunk IsJunk="false" MoveItem="true">
        <m:ItemIds>
          <t:ItemId Id="AAMkAD=" ChangeKey="CQAAABYu" />
        </m:ItemIds>
      </m:MarkAsJunk>
    </soap:Body>
 </soap:Envelope>

Успешный ответ на удаление отправителя из списка заблокированных отправителей совпадает с ответом на добавление отправителя в список заблокированных отправителей.

Текст SOAP запроса содержит следующие элементы:

Ответ на ошибку операции MarkAsJunk

В следующем примере показан ответ на ошибку на запрос операции MarkAsJunk . Это ответ на запрос на добавление или удаление отправителя из списка заблокированных отправителей, если сообщение электронной почты, указанное идентификатором элемента, больше не существует в почтовом ящике.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="15" 
                         MinorVersion="0" 
                         MajorBuildNumber="545" 
                         MinorBuildNumber="11" 
                         Version="Exchange2013" 
                         xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <m:MarkAsJunkResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:MarkAsJunkResponseMessage ResponseClass="Error">
          <m:MessageText>The specified object was not found in the store.</m:MessageText>
          <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:MarkAsJunkResponseMessage>
      </m:ResponseMessages>
    </m:MarkAsJunkResponse>
  </s:Body>
</s:Envelope>

Текст soap ответа на ошибку содержит следующие элементы:

См. также