Операция MarkAsJunkMarkAsJunk operation

Поиск сведений о MarkAsJunkной операции EWS.Find information about the MarkAsJunk EWS operation.

Операция MarkAsJunk добавляет и удаляет пользователей из списка заблокированных сообщений электронной почты и перемещает сообщения электронной почты в папку "Нежелательная почта".The MarkAsJunk operation adds and removes users from the blocked email list and moves email messages to the Junk Email folder.

Эта операция появилась в Exchange Server 2013.This operation was introduced in Exchange Server 2013.

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

Операция MarkAsJunk содержит два логических параметра, указывающие, следует ли добавить отправителя электронной почты в список заблокированных отправителей и следует ли переместить целевое сообщение электронной почты в папку нежелательной почты по умолчанию или папку "Входящие".The MarkAsJunk operation contains two Boolean options to indicate whether an email sender should be added to the blocked sender list and whether the target email message should be moved to the default Junk Email folder or the Inbox folder. Действия определяются значениями атрибутов MoveItem и нежелательной почты .The actions are determined by the values of the IsJunk and MoveItem attributes. Ниже приведены возможные действия, основанные на комбинациях значений для атрибутов MoveItem и нежелательной почты :The following are the possible actions based on the value combinations for the IsJunk and MoveItem attributes:

  • Если атрибуту InAttribute присвоено значение true, а атрибуту MoveItem присвоено значение true, отправитель целевого сообщения электронной почты добавляется в список заблокированных отправителей и сообщение электронной почты перемещается в папку "Нежелательная дмаил".If the IsJunk attribute is set to true, and the MoveItem attribute is set to true, the sender of the target email message is added to the blocked sender list and the email message is moved to the Junk Dmail folder.

  • Если атрибуту InAttribute присвоено значение true, а атрибуту MoveItem присвоено значение false, отправитель целевого сообщения электронной почты добавляется в список заблокированных отправителей, а сообщение электронной почты не перемещается из нее.If the IsJunk attribute is set to true, and the MoveItem attribute is set to false, the sender of the target email message is added to the blocked sender list and the email message is not moved from the folder.

  • Если атрибуту InAttribute присвоено значение false, а атрибуту MoveItem присвоено значение true, то отправитель целевого сообщения электронной почты удален из списка заблокированных отправителей, а сообщение электронной почты перемещается в папку "Входящие".If the IsJunk attribute is set to false, and the MoveItem attribute is set to true, the sender of the target email messageis removed from the blocked sender list and the email message is moved to the Inbox folder.

  • Если атрибуту InAttribute присвоено значение false, а атрибуту MoveItem присвоено значение false, то отправитель целевого сообщения электронной почты удаляется из списка заблокированных отправителей, а сообщение электронной почты не перемещается из папки.If the IsJunk attribute is set to false, and the MoveItem attribute is set to false, the sender of the target email message is removed from the blocked sender list and the email message is not moved from the folder.

Важно!

Содержимое списка заблокированных отправителей не обнаруживается в EWS.The contents of the blocked sender list are not discoverable from EWS. Если отправитель добавляется в список заблокированных отправителей, необходимо сохранить копию сообщения электронной почты, отправленного заблокированным отправителем, чтобы разблокировать отправителя в будущем.If a sender is added to the blocked sender list, you need to keep a copy of an email message sent by the blocked sender to unblock the sender in the future.

Заголовки SOAP операции MarkAsJunkMarkAsJunk operation SOAP headers

Операция MarkAsJunk может использовать заголовки SOAP, указанные в приведенной ниже таблице.The MarkAsJunk operation can use the SOAP headers that are listed in the following table.

Имя заголовкаHeader name ЭлементElement ОписаниеDescription
ОлицетворениеImpersonation
ексчанжеимперсонатионExchangeImpersonation
Идентифицирует пользователя, который олицетворяет клиентское приложение.Identifies the user whom the client application is impersonating. Этот заголовок является применимым для запроса.This header is applicable to a request.
маилбокскултуреMailboxCulture
маилбокскултуреMailboxCulture
Определяет язык и региональные параметры, определенные в документе RFC 3066 "Теги для идентификации языков", которые будут использоваться для доступа к почтовому ящику.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Этот заголовок является применимым для запроса.This header is applicable to a request.
рекуестверсионRequestVersion
рекуестсерверверсионRequestServerVersion
Определяет версию схемы для запроса операции.Identifies the schema version for the operation request. Этот заголовок является применимым для запроса.This header is applicable to a request.
серверверсионServerVersion
серверверсионинфоServerVersionInfo
Определяет версию сервера, который ответил на запрос.Identifies the version of the server that responded to the request. Этот заголовок является применимым для отклика.This header is applicable to a response.

Пример запроса операции MarkAsJunk: Добавление отправителя в список заблокированных отправителейMarkAsJunk operation request example: Add a sender to the blocked sender list

В следующем примере запроса операции MarkAsJunk показано, как добавить отправителя электронного письма в список заблокированных отправителей и переместить сообщение в папку нежелательной почты.The following example of a MarkAsJunk operation request shows how to add the sender of an email to the blocked sender list and move the email to the junk mail folder. Операция MarkAsJunk принимает уникальный идентификатор электронного сообщения, чтобы определить адрес электронной почты, который используется для ссылки на отправителя, добавляемого в список заблокированных отправителей.The MarkAsJunk operation accepts the unique email message identifier to identify the email that is used to reference the sender that is added to the blocked sender list.

Примечание

Все идентификаторы элементов и изменения ключей в этой статье были сокращены, чтобы сохранить удобочитаемость.All item identifiers and change keys in this article have been shortened to preserve readability.

<?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 Request содержит следующие элементы:The request SOAP body contains the following elements:

Успешный отклик операции MarkAsJunkSuccessful MarkAsJunk operation response

В следующем примере показан успешный ответ на запрос операции MarkAsJunk для добавления отправителя в список заблокированных отправителей и перемещения сообщения электронной почты в папку нежелательной почты.The following example shows a successful response to a MarkAsJunk operation request to add a sender to the blocked sender list and move the email message to the Junk Email folder.

<?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 отклика содержит следующие элементы:The response SOAP body contains the following elements:

Пример запроса операции MarkAsJunk: Удаление отправителя из списка заблокированных отправителейMarkAsJunk operation request example: Remove a sender from the blocked sender list

В приведенном ниже примере запроса операции MarkAsJunk показано, как удалить отправителя сообщения электронной почты из списка заблокированных отправителей и переместить сообщение в папку "Входящие".The following example of a MarkAsJunk operation request shows how to remove the sender of an email message from the blocked sender list and move the email message to the Inbox folder. Чтобы удалить отправителя из списка заблокированных отправителей, необходимо оставить сообщение электронной почты, отправленное заблокированным отправителем.You need to keep an email message sent by the blocked sender to remove the sender from the blocked sender list. Адрес электронной почты отправителя связан с сообщениями электронной почты, отправленными отправителями.The sender's email address is associated with email messages that have been sent by the sender. Удаление отправителя из списка заблокированных отправителей не будет успешным, если справочное сообщение электронной почты больше не существует в почтовом ящике пользователя.Removing a sender from the blocked sender list will not succeed if the reference email message no longer exists in the user's mailbox. Идентификатор элемента, используемый для связи с сообщением электронной почты с отправителями, должен быть связан с элементом, который существует в почтовом ящике Exchange.The item identifier used to associate an email message with its sender must be associated with an item that exists in the Exchange mailbox. Рекомендуется создать скрытую папку для хранения элементов, отправленных ранее заблокированными отправителями, чтобы отправители можно было разблокировать из клиентского приложения.We recommend that you create a hidden folder to store items sent by previously blocked senders so that the senders can be unblocked from the client application. В случае, если элемент удален из почтового ящика Exchange, администратору необходимо использовать консоль управления Exchange для доступа к списку заблокированных отправителей, чтобы удалить отправителя из списка.In the event that an item has been removed from the Exchange mailbox, an administrator has to use the Exchange Management Console to access the blocked sender list to remove a sender from the list. Сведения о том, как разблокировать пользователя с помощью консоли управления Exchange, можно узнать в статье Настройка параметров надежных отправителей и заблокированных отправителей в Office 365.For information about how to unblock a user by using the Exchange Management Console, see How to configure the safe senders and blocked senders settings in 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>

Успешный ответ на удаление отправителя из списка заблокированных отправителей совпадает с ответом на Добавление отправителя в список заблокированных отправителей.A successful response for removing a sender from the blocked sender list is the same as the response for adding a sender to the blocked sender list.

Текст SOAP Request содержит следующие элементы:The request SOAP body contains the following elements:

Ответ об ошибке операции MarkAsJunkMarkAsJunk operation error response

В следующем примере показан ответ об ошибке для запроса операции MarkAsJunk .The following example shows an error response to a MarkAsJunk operation request. Это ответ на запрос на добавление или удаление отправителя из списка заблокированных отправителей, если сообщение электронной почты, заданное идентификатором элемента, больше не существует в почтовом ящике.This is a response to a request to add or remove a sender from the blocked sender list when the email message specified by the item identifier no longer exists in the mailbox.

<?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 содержит следующие элементы:The error response SOAP body contains the following elements:

См. такжеSee also