Operación MarkAsJunk

Artículo
03/29/2023

Busque información sobre la operación EWS MarkAsJunk .

La operación MarkAsJunk agrega y quita usuarios de la lista de correo electrónico bloqueado y mueve los mensajes de correo electrónico a la carpeta de Email no deseado.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación MarkAsJunk

La operación MarkAsJunk contiene dos opciones booleanas para indicar si se debe agregar un remitente de correo electrónico a la lista de remitentes bloqueados y si el mensaje de correo electrónico de destino debe moverse a la carpeta de Email correo no deseado predeterminada o a la carpeta Bandeja de entrada. Las acciones están determinadas por los valores de los atributos IsJunk y MoveItem . A continuación se muestran las posibles acciones basadas en las combinaciones de valores para los atributos IsJunk y MoveItem :

Si el atributo IsJunk se establece en true y el atributo MoveItem se establece en true, el remitente del mensaje de correo electrónico de destino se agrega a la lista de remitentes bloqueados y el mensaje de correo electrónico se mueve a la carpeta Correo no deseado.
Si el atributo IsJunk se establece en true y el atributo MoveItem se establece en false, el remitente del mensaje de correo electrónico de destino se agrega a la lista de remitentes bloqueados y el mensaje de correo electrónico no se mueve de la carpeta.
Si el atributo IsJunk se establece en false y el atributo MoveItem se establece en true, el remitente del mensaje de correo electrónico de destino se quita de la lista de remitentes bloqueados y el mensaje de correo electrónico se mueve a la carpeta Bandeja de entrada.
Si el atributo IsJunk se establece en false y el atributo MoveItem se establece en false, el remitente del mensaje de correo electrónico de destino se quita de la lista de remitentes bloqueados y el mensaje de correo electrónico no se mueve de la carpeta.

Importante

El contenido de la lista de remitentes bloqueados no se puede detectar desde EWS. Si se agrega un remitente a la lista de remitentes bloqueados, debe conservar una copia de un mensaje de correo electrónico enviado por el remitente bloqueado para desbloquearlo en el futuro.

Encabezados SOAP de la operación MarkAsJunk

La operación MarkAsJunk puede usar los encabezados SOAP que aparecen en la tabla siguiente.

Nombre de encabezado	Elemento	Descripción
Suplantación	ExchangeImpersonation	Identifica al usuario al que suplanta la aplicación cliente. Este encabezado es aplicable a una solicitud.
MailboxCulture	MailboxCulture	Identifica la referencia cultural, tal como se define en RFC 3066, "Etiquetas para la identificación de idiomas", que se usará para acceder al buzón. Este encabezado es aplicable a una solicitud.
RequestVersion	RequestServerVersion	Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud.
ServerVersion	ServerVersionInfo	Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta.

Ejemplo de solicitud de operación MarkAsJunk: agregar un remitente a la lista de remitentes bloqueados

En el ejemplo siguiente de una solicitud de operación MarkAsJunk se muestra cómo agregar el remitente de un correo electrónico a la lista de remitentes bloqueados y mover el correo electrónico a la carpeta de correo no deseado. La operación MarkAsJunk acepta el identificador de mensaje de correo electrónico único para identificar el correo electrónico que se usa para hacer referencia al remitente que se agrega a la lista de remitentes bloqueados.

Nota:

Todos los identificadores de elemento y las claves de cambio de este artículo se han acortado para conservar la legibilidad.

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

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta correcta de la operación MarkAsJunk

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación MarkAsJunk para agregar un remitente a la lista de remitentes bloqueados y mover el mensaje de correo electrónico a la carpeta Email no deseado.

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

El cuerpo soap de respuesta contiene los siguientes elementos:

Ejemplo de solicitud de operación MarkAsJunk: quitar un remitente de la lista de remitentes bloqueados

En el ejemplo siguiente de una solicitud de operación MarkAsJunk se muestra cómo quitar el remitente de un mensaje de correo electrónico de la lista de remitentes bloqueados y mover el mensaje de correo electrónico a la carpeta Bandeja de entrada. Debe mantener un mensaje de correo electrónico enviado por el remitente bloqueado para quitarlo de la lista de remitentes bloqueados. La dirección de correo electrónico del remitente está asociada a los mensajes de correo electrónico enviados por el remitente. La eliminación de un remitente de la lista de remitentes bloqueados no se realizará correctamente si el mensaje de correo electrónico de referencia ya no existe en el buzón del usuario. El identificador de elemento usado para asociar un mensaje de correo electrónico a su remitente debe estar asociado a un elemento que exista en el buzón de Exchange. Se recomienda crear una carpeta oculta para almacenar los elementos enviados por remitentes bloqueados previamente para que los remitentes se puedan desbloquear desde la aplicación cliente. En caso de que se haya quitado un elemento del buzón de Exchange, un administrador debe usar el Consola de administración de Exchange para acceder a la lista de remitentes bloqueados para quitar un remitente de la lista. Para obtener información sobre cómo desbloquear un usuario mediante el Consola de administración de Exchange, consulte Configuración de remitentes seguros y remitentes bloqueados en 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>

Una respuesta correcta para quitar un remitente de la lista de remitentes bloqueados es la misma que la respuesta para agregar un remitente a la lista de remitentes bloqueados.

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta de error de la operación MarkAsJunk

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación MarkAsJunk . Se trata de una respuesta a una solicitud para agregar o quitar un remitente de la lista de remitentes bloqueados cuando el mensaje de correo electrónico especificado por el identificador de elemento ya no existe en el buzón.

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

El cuerpo SOAP de la respuesta de error contiene los siguientes elementos:

Share via