Operação MarkAsJunk

  • Artigo

Encontre informações sobre a operação MarkAsJunk EWS.

A operação MarkAsJunk adiciona e remove os usuários da lista de email bloqueada e move mensagens de email para a pasta Junk Email.

This operation was introduced in Exchange Server 2013.

Usando a operação MarkAsJunk

A operação MarkAsJunk contém duas opções boolianas 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 junk Email padrão ou a pasta Caixa de Entrada. As ações são determinadas pelos valores dos atributos IsJunk e MoveItem . A seguir estão as possíveis ações com base nas combinações de valor para os atributos IsJunk e MoveItem :

  • Se o atributo IsJunk estiver definido como true e o atributo MoveItem estiver definido como true, o remetente da mensagem de email de destino será adicionado à lista de remetente bloqueado e a mensagem de email será movida para a pasta Junk Dmail.

  • Se o atributo IsJunk estiver definido como true e o atributo MoveItem estiver definido como false, o remetente da mensagem de email de destino será adicionado à lista de remetente bloqueado e a mensagem de email não será movida da pasta.

  • Se o atributo IsJunk estiver definido como false e o atributo MoveItem estiver definido como true, o remetente das mensagens de email de destino será removido da lista de remetente bloqueado e a mensagem de email será movida para a pasta Caixa de Entrada.

  • Se o atributo IsJunk estiver definido como false e o atributo MoveItem estiver definido como false, o remetente da mensagem de email de destino será removido da lista de remetente bloqueado e a mensagem de email não será movida da pasta.

Importante

O conteúdo da lista de remetente bloqueado não é detectável do EWS. Se um remetente for adicionado à lista de remetente bloqueado, você precisará manter uma cópia de uma mensagem de email enviada pelo remetente bloqueado para desbloquear o remetente no futuro.

Cabeçalhos SOAP da operação MarkAsJunk

A operação MarkAsJunk pode usar os cabeçalhos SOAP listados na tabela a seguir.

Nome de cabeçalho Elemento Descrição
Representação
ExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando. Esse cabeçalho é aplicável a uma solicitação.
MailboxCulture
MailboxCulture
Identifica a cultura, conforme definido no RFC 3066, "Marcas para a Identificação de Idiomas", a ser usada para acessar a caixa de correio. Esse cabeçalho é aplicável a uma solicitação.
RequestVersion
RequestServerVersion
Identifica a versão do esquema para a solicitação de operação. Esse cabeçalho é aplicável a uma solicitação.
Serverversion
ServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação. Esse cabeçalho é aplicável a uma resposta.

Exemplo de solicitação de operação MarkAsJunk: adicionar um remetente à lista de remetente bloqueado

O exemplo a seguir de uma solicitação de operação MarkAsJunk mostra como adicionar o remetente de um email à lista de remetente bloqueado e mover o email para a pasta lixo eletrônico. A operação MarkAsJunk aceita o identificador de mensagem de email exclusivo para identificar o email usado para fazer referência ao remetente adicionado à lista de remetente bloqueado.

Observação

Todos os identificadores de item e chaves de alteração neste artigo foram encurtados para preservar a legibilidade.

<?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:

Resposta bem-sucedida da operação MarkAsJunk

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação MarkAsJunk para adicionar um remetente à lista de remetente bloqueado e mover a mensagem de email para a pasta Junk 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>

O corpo SOAP de resposta contém os seguintes elementos:

Exemplo de solicitação de operação MarkAsJunk: remover um remetente da lista de remetente bloqueado

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 remetente bloqueada e mover a mensagem de email para a pasta Caixa de Entrada. Você precisa manter uma mensagem de email enviada pelo remetente bloqueado para remover o remetente da lista de remetente bloqueada. O endereço de email do remetente está associado a mensagens de email enviadas pelo remetente. A remoção de um remetente da lista de remetente bloqueada não será bem-sucedida se a mensagem de email de referência não existir mais na caixa de correio do usuário. 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. 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. No caso de um item ter sido removido da caixa de correio do Exchange, um administrador precisará usar o Console de Gerenciamento do Exchange para acessar a lista de remetente bloqueada para remover um remetente da lista. Para obter informações sobre como desbloquear um usuário usando o Console de Gerenciamento do Exchange, consulte Como configurar os remetentes seguros e as configurações de remetentes bloqueados no 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 remetente bloqueado é a mesma da resposta para adicionar um remetente à lista de remetente bloqueado.

O corpo SOAP de solicitação contém os seguintes elementos:

Resposta de erro da operação MarkAsJunk

O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação MarkAsJunk . Essa é uma resposta a uma solicitação para adicionar ou remover um remetente da lista de remetente bloqueada quando a mensagem de email especificada pelo identificador de item não existe mais na caixa de correio.

<?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:

Confira também