Opération MarkAsJunk

Article
03/29/2023

Trouvez des informations sur l’opération EWS MarkAsJunk .

L’opération MarkAsJunk ajoute et supprime des utilisateurs de la liste des e-mails bloqués et déplace les messages électroniques vers le dossier Email indésirable.

Cette opération est une nouveauté d’Exchange Server 2013.

Utilisation de l’opération MarkAsJunk

L’opération MarkAsJunk contient deux options booléennes pour indiquer si un expéditeur de courrier électronique doit être ajouté à la liste des expéditeurs bloqués et si le message électronique cible doit être déplacé vers le dossier Email indésirable par défaut ou le dossier Boîte de réception. Les actions sont déterminées par les valeurs des attributs IsJunk et MoveItem . Voici les actions possibles basées sur les combinaisons de valeurs pour les attributs IsJunk et MoveItem :

Si l’attribut IsJunk est défini sur true et que l’attribut MoveItem a la valeur true, l’expéditeur du message électronique cible est ajouté à la liste des expéditeurs bloqués et le message électronique est déplacé vers le dossier Courrier indésirable.
Si l’attribut IsJunk est défini sur true et que l’attribut MoveItem a la valeur false, l’expéditeur du message électronique cible est ajouté à la liste des expéditeurs bloqués et le message électronique n’est pas déplacé du dossier.
Si l’attribut IsJunk est défini sur false et que l’attribut MoveItem a la valeur true, l’expéditeur du message électronique cible est supprimé de la liste des expéditeurs bloqués et le message électronique est déplacé vers le dossier Boîte de réception.
Si l’attribut IsJunk est défini sur false et que l’attribut MoveItem a la valeur false, l’expéditeur du message électronique cible est supprimé de la liste des expéditeurs bloqués et le message électronique n’est pas déplacé du dossier.

Importante

Le contenu de la liste des expéditeurs bloqués n’est pas détectable à partir d’EWS. Si un expéditeur est ajouté à la liste des expéditeurs bloqués, vous devez conserver une copie d’un e-mail envoyé par l’expéditeur bloqué pour débloquer l’expéditeur à l’avenir.

En-têtes SOAP de l’opération MarkAsJunk

L’opération MarkAsJunk peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.

Nom de l'en-tête	Élément	Description
Imitation	ExchangeImpersonation	Identifie l’utilisateur que l’application cliente emprunte l’identité. Cet en-tête s’applique à une requête.
MailboxCulture	MailboxCulture	Identifie la culture, telle que définie dans la RFC 3066, « Balises pour l’identification des langues », à utiliser pour accéder à la boîte aux lettres. Cet en-tête s’applique à une requête.
RequestVersion	RequestServerVersion	Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion	ServerVersionInfo	Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération MarkAsJunk : Ajouter un expéditeur à la liste des expéditeurs bloqués

L’exemple suivant de demande d’opération MarkAsJunk montre comment ajouter l’expéditeur d’un e-mail à la liste des expéditeurs bloqués et déplacer l’e-mail vers le dossier courrier indésirable. L’opération MarkAsJunk accepte l’identificateur unique du message électronique pour identifier l’e-mail utilisé pour référencer l’expéditeur ajouté à la liste des expéditeurs bloqués.

Remarque

Tous les identificateurs d’élément et les clés de modification de cet article ont été raccourcis pour préserver la lisibilité.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://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>

Le corps SOAP de la demande contient les éléments suivants :

Réponse de l’opération MarkAsJunk réussie

L’exemple suivant montre une réponse réussie à une demande d’opération MarkAsJunk pour ajouter un expéditeur à la liste des expéditeurs bloqués et déplacer le message électronique vers le dossier Email indésirable.

<?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="http://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/messages" 
                              xmlns:t="http://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>

Le corps SOAP de la réponse contient les éléments suivants :

Exemple de demande d’opération MarkAsJunk : Supprimer un expéditeur de la liste des expéditeurs bloqués

L’exemple suivant de demande d’opération MarkAsJunk montre comment supprimer l’expéditeur d’un e-mail de la liste des expéditeurs bloqués et déplacer le message électronique vers le dossier Boîte de réception. Vous devez conserver un e-mail envoyé par l’expéditeur bloqué pour supprimer l’expéditeur de la liste des expéditeurs bloqués. L’adresse e-mail de l’expéditeur est associée aux messages électroniques qui ont été envoyés par l’expéditeur. La suppression d’un expéditeur de la liste des expéditeurs bloqués échoue si le message électronique de référence n’existe plus dans la boîte aux lettres de l’utilisateur. L’identificateur d’élément utilisé pour associer un e-mail à son expéditeur doit être associé à un élément qui existe dans la boîte aux lettres Exchange. Nous vous recommandons de créer un dossier masqué pour stocker les éléments envoyés par des expéditeurs précédemment bloqués afin que les expéditeurs puissent être débloqués à partir de l’application cliente. Dans le cas où un élément a été supprimé de la boîte aux lettres Exchange, un administrateur doit utiliser la console de gestion Exchange pour accéder à la liste des expéditeurs bloqués afin de supprimer un expéditeur de la liste. Pour plus d’informations sur le déblocage d’un utilisateur à l’aide de la console de gestion Exchange, consultez Comment configurer les paramètres des expéditeurs approuvés et des expéditeurs bloqués dans Office 365.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://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>

Une réponse réussie pour supprimer un expéditeur de la liste des expéditeurs bloqués est identique à la réponse pour ajouter un expéditeur à la liste des expéditeurs bloqués.

Le corps SOAP de la demande contient les éléments suivants :

Réponse d’erreur d’opération MarkAsJunk

L’exemple suivant montre une réponse d’erreur à une demande d’opération MarkAsJunk . Il s’agit d’une réponse à une demande d’ajout ou de suppression d’un expéditeur de la liste des expéditeurs bloqués lorsque le message électronique spécifié par l’identificateur d’élément n’existe plus dans la boîte aux lettres.

<?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="http://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="http://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>

Le corps SOAP de la réponse d’erreur contient les éléments suivants :

Partager via