Operación MarkAsJunkMarkAsJunk operation

Buscar información sobre la operación de EWS de MarkAsJunk .Find information about the MarkAsJunk EWS operation.

La operación MarkAsJunk agrega y quita usuarios de la lista de correos electrónicos bloqueados y mueve los mensajes de correo electrónico a la carpeta de correo no deseado.The MarkAsJunk operation adds and removes users from the blocked email list and moves email messages to the Junk Email folder.

Esta operación se introdujo en Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Uso de la operación MarkAsJunkUsing the MarkAsJunk operation

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 correo electrónico no deseado o a la carpeta Bandeja de entrada predeterminada.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. Las acciones vienen determinadas por los valores de los atributos IsJunk y MoveItem .The actions are determined by the values of the IsJunk and MoveItem attributes. A continuación se indican las acciones posibles en función de las combinaciones de valores para los atributos IsJunk y MoveItem :The following are the possible actions based on the value combinations for the IsJunk and MoveItem attributes:

  • Si el atributo IsJunk se establece en truey 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 de Dmail de correo no deseado.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.

  • Si el atributo IsJunk se establece en truey 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.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.

  • Si el atributo IsJunk está establecido en falsey 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.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.

  • Si el atributo IsJunk está establecido en falsey 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.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

El contenido de la lista de remitentes bloqueados no se detecta desde EWS.The contents of the blocked sender list are not discoverable from 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 desbloquear el remitente en el 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.

Encabezados SOAP de operación MarkAsJunkMarkAsJunk operation SOAP headers

La operación MarkAsJunk puede usar los encabezados SOAP que se enumeran en la tabla siguiente.The MarkAsJunk operation can use the SOAP headers that are listed in the following table.

Nombre de encabezadoHeader name ElementoElement DescripciónDescription
SuplantaciónImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica al usuario que está suplantando la aplicación cliente.Identifies the user whom the client application is impersonating. Este encabezado se aplica a una solicitud.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica la referencia cultural, tal y como se define en RFC 3066, "etiquetas para la identificación de idiomas", que se va a usar para obtener acceso al buzón.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Este encabezado se aplica a una solicitud.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación.Identifies the schema version for the operation request. Este encabezado se aplica a una solicitud.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request. Este encabezado se aplica a una respuesta.This header is applicable to a response.

Ejemplo de solicitud de operación MarkAsJunk: agregar un remitente a la lista de remitentes bloqueadosMarkAsJunk operation request example: Add a sender to the blocked sender list

El siguiente ejemplo de una solicitud de operación de MarkAsJunk 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.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. 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.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.

Nota

Todos los identificadores de elemento y las claves de cambio de este artículo se han reducido para preservar la legibilidad.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>

El cuerpo SOAP de la solicitud contiene los siguientes elementos:The request SOAP body contains the following elements:

Respuesta de operación MarkAsJunk correctaSuccessful MarkAsJunk operation response

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación de MarkAsJunk para agregar un remitente a la lista de remitentes bloqueados y mover el mensaje de correo electrónico a la carpeta de correo electrónico no deseado.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>

El cuerpo SOAP de respuesta contiene los siguientes elementos:The response SOAP body contains the following elements:

Ejemplo de solicitud de operación MarkAsJunk: quitar un remitente de la lista de remitentes bloqueadosMarkAsJunk operation request example: Remove a sender from the blocked sender list

El siguiente ejemplo de una solicitud de operación de MarkAsJunk 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.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. Debe conservar un mensaje de correo electrónico enviado por el remitente bloqueado para quitar el remitente de la lista de remitentes bloqueados.You need to keep an email message sent by the blocked sender to remove the sender from the blocked sender list. La dirección de correo electrónico del remitente está asociada con los mensajes de correo electrónico enviados por el remitente.The sender's email address is associated with email messages that have been sent by the sender. Si se quita un remitente de la lista de remitentes bloqueados, no se realizará correctamente si el mensaje de correo de referencia ya no existe en el buzón del usuario.Removing a sender from the blocked sender list will not succeed if the reference email message no longer exists in the user's mailbox. El identificador del elemento que se usa para asociar un mensaje de correo electrónico con su remitente debe estar asociado con un elemento que exista en el buzón de 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. Le recomendamos que cree una carpeta oculta para almacenar los elementos enviados por los remitentes previamente bloqueados para que los remitentes se puedan desbloquear desde la aplicación 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. En el caso de que se haya quitado un elemento del buzón de Exchange, un administrador tiene que usar la consola de administración de Exchange para tener acceso a la lista de remitentes bloqueados y quitar un remitente de la 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 obtener información acerca de cómo desbloquear un usuario mediante la consola de administración de Exchange, consulte How to Configure The Safe Senders and blocked Senders Settings in 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>

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

El cuerpo SOAP de la solicitud contiene los siguientes elementos:The request SOAP body contains the following elements:

Respuesta de error de operación de MarkAsJunkMarkAsJunk operation error response

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación MarkAsJunk .The following example shows an error response to a MarkAsJunk operation request. Se trata de una respuesta a una solicitud de adición o eliminación de 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.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>

El cuerpo SOAP de respuesta de error contiene los siguientes elementos:The error response SOAP body contains the following elements:

Vea tambiénSee also