Operação MarkAsJunkMarkAsJunk operation

Encontre informações sobre a operação do EWS do MarkAsJunk .Find information about the MarkAsJunk EWS operation.

A operação MarkAsJunk adiciona e remove usuários da lista de e-mails bloqueados e move mensagens de email para a pasta lixo eletrônico.The MarkAsJunk operation adds and removes users from the blocked email list and moves email messages to the Junk Email folder.

This operation was introduced in Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Usando a operação MarkAsJunkUsing the MarkAsJunk operation

A operação MarkAsJunk contém duas opções booleanas para indicar se um remetente de email deve ser adicionado à lista de remetentes bloqueados e se a mensagem de email de destino deve ser movida para a pasta de lixo eletrônico padrão ou para a pasta caixa de entrada.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. As ações são determinadas pelos valores dos atributos islixo e MoveItem .The actions are determined by the values of the IsJunk and MoveItem attributes. A seguir estão as ações possíveis com base nas combinações de valor dos atributos isjunk e MoveItem :The following are the possible actions based on the value combinations for the IsJunk and MoveItem attributes:

  • Se o atributo islixo estiver definido como truee o atributo MoveItem estiver definido como true, o remetente da mensagem de email de destino será adicionado à lista de remetentes bloqueados e a mensagem de email será movida para a pasta lixo eletrônico.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.

  • Se o atributo islixo estiver definido como truee o atributo MoveItem estiver definido como false, o remetente da mensagem de email de destino será adicionado à lista de remetentes bloqueados e a mensagem de email não será movida da pasta.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.

  • Se o atributo isjunk for definido como falsee o atributo MoveItem estiver definido como true, o remetente da mensagem de email de destino será removido da lista de remetentes bloqueados e a mensagem de email será movida para a pasta caixa de entrada.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.

  • Se o atributo isjunk for definido como falsee o atributo MoveItem for definido como false, o remetente da mensagem de email de destino será removido da lista de remetentes bloqueados e a mensagem de email não será movida da pasta.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.

Importante

O conteúdo da lista de remetentes bloqueados não é detectável do EWS.The contents of the blocked sender list are not discoverable from EWS. Se um remetente for adicionado à lista de remetentes bloqueados, você precisará manter uma cópia de uma mensagem de email enviada pelo remetente bloqueado para desbloquear o remetente no futuro.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.

Cabeçalhos SOAP de operação MarkAsJunkMarkAsJunk operation SOAP headers

A operação MarkAsJunk pode usar os cabeçalhos SOAP listados na tabela a seguir.The MarkAsJunk operation can use the SOAP headers that are listed in the following table.

Nome de cabeçalhoHeader name ElementoElement DescriçãoDescription
RepresentaçãoImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando.Identifies the user whom the client application is impersonating. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica a cultura, conforme definido na RFC 3066, "marcas de identificação de idiomas", a ser usado para acessar a caixa de correio.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica a versão do esquema para a solicitação de operação.Identifies the schema version for the operation request. Este cabeçalho é aplicável a uma solicitação.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação.Identifies the version of the server that responded to the request. Este cabeçalho é aplicável a uma resposta.This header is applicable to a response.

Exemplo de solicitação de operação MarkAsJunk: adicionar um remetente à lista de remetentes bloqueadosMarkAsJunk operation request example: Add a sender to the blocked sender list

O exemplo a seguir de uma solicitação de operação MarkAsJunk mostra como adicionar o remetente de um email à lista de remetentes bloqueados e mover o email para a pasta lixo eletrônico.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. A operação MarkAsJunk aceita o identificador de mensagem de email exclusivo para identificar o email que é usado para fazer referência ao remetente adicionado à lista de remetentes bloqueados.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.

Observação

Todos os identificadores de item e as chaves de alteração deste artigo foram reduzidos para preservar a legibilidade.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>

O corpo SOAP de solicitação contém os seguintes elementos:The request SOAP body contains the following elements:

Resposta de operação MarkAsJunk bem-sucedidaSuccessful MarkAsJunk operation response

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação de MarkAsJunk para adicionar um remetente à lista de remetentes bloqueados e mover a mensagem de email para a pasta lixo eletrônico.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>

O corpo SOAP de resposta contém os seguintes elementos:The response SOAP body contains the following elements:

Exemplo de solicitação de operação MarkAsJunk: remover um remetente da lista de remetentes bloqueadosMarkAsJunk operation request example: Remove a sender from the blocked sender list

O exemplo a seguir de uma solicitação de operação MarkAsJunk mostra como remover o remetente de uma mensagem de email da lista de remetentes bloqueados e mover a mensagem de email para a pasta caixa de entrada.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. Você precisa manter uma mensagem de email enviada pelo remetente bloqueado para remover o remetente da lista de remetentes bloqueados.You need to keep an email message sent by the blocked sender to remove the sender from the blocked sender list. O endereço de email do remetente é associado a mensagens de email enviadas pelo remetente.The sender's email address is associated with email messages that have been sent by the sender. A remoção de um remetente da lista de remetentes bloqueados não será bem-sucedida se a mensagem de email de referência não existir mais na caixa de correio do usuário.Removing a sender from the blocked sender list will not succeed if the reference email message no longer exists in the user's mailbox. O identificador de item usado para associar uma mensagem de email ao remetente deve estar associado a um item que existe na caixa de correio do 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. Recomendamos que você crie uma pasta oculta para armazenar itens enviados por remetentes bloqueados anteriormente para que os remetentes possam ser desbloqueados do aplicativo cliente.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. No caso de um item ter sido removido da caixa de correio do Exchange, um administrador deve usar o console de gerenciamento do Exchange para acessar a lista de remetentes bloqueados para remover um remetente da lista.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. Para obter informações sobre como desbloquear um usuário usando o console de gerenciamento do Exchange, consulte como configurar as configurações de remetentes confiáveis e remetentes bloqueados no 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>

Uma resposta bem-sucedida para remover um remetente da lista de remetentes bloqueados é o mesmo que a resposta para adicionar um remetente à lista de remetentes bloqueados.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.

O corpo SOAP de solicitação contém os seguintes elementos:The request SOAP body contains the following elements:

Resposta de erro de operação MarkAsJunkMarkAsJunk operation error response

O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação MarkAsJunk .The following example shows an error response to a MarkAsJunk operation request. Esta é uma resposta a uma solicitação para adicionar ou remover um remetente da lista de remetentes bloqueados quando a mensagem de email especificada pelo identificador de item não existe mais na caixa de correio.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>

O corpo SOAP de resposta de erro contém os seguintes elementos:The error response SOAP body contains the following elements:

Confira tambémSee also