MarkAsJunk 操作

  • [アーティクル]

MarkAsJunk EWS 操作に関する情報を検索します。

MarkAsJunk 操作は、ブロックされたメール リストからユーザーを追加および削除し、電子メール メッセージを迷惑メール Email フォルダーに移動します。

この操作は Exchange Server 2013 で導入されました。

MarkAsJunk 操作の使用

MarkAsJunk 操作には、2 つのブール値オプションが含まれており、電子メール送信者をブロックされた送信者リストに追加する必要があるかどうか、およびターゲット電子メール メッセージを既定の迷惑メール Email フォルダーまたは受信トレイ フォルダーに移動するかどうかを示します。 アクションは、 IsJunk 属性と MoveItem 属性の値によって決まります。 IsJunk 属性と MoveItem 属性の値の組み合わせに基づいて考えられるアクションを次に示します。

  • IsJunk 属性が true に設定され、MoveItem 属性が true に設定されている場合、対象の電子メール メッセージの送信者がブロックされている送信者リストに追加され、電子メール メッセージが迷惑メール フォルダーに移動されます。

  • IsJunk 属性が true に設定され、MoveItem 属性が false に設定されている場合、対象の電子メール メッセージの送信者がブロックされている送信者リストに追加され、電子メール メッセージはフォルダーから移動されません。

  • IsJunk 属性が false に設定され、MoveItem 属性が true に設定されている場合、対象の電子メール メッセージの送信者はブロックされた送信者リストから削除され、電子メール メッセージは受信トレイ フォルダーに移動されます。

  • IsJunk 属性が false に設定され、MoveItem 属性が false に設定されている場合、対象の電子メール メッセージの送信者はブロックされた送信者リストから削除され、電子メール メッセージはフォルダーから移動されません。

重要

ブロックされた送信者リストの内容は、EWS から検出できません。 送信者がブロックされた送信者リストに追加された場合は、ブロックされた送信者によって送信された電子メール メッセージのコピーを保持して、今後送信者のブロックを解除する必要があります。

MarkAsJunk 操作 SOAP ヘッダー

MarkAsJunk 操作では、次の表に示す SOAP ヘッダーを使用できます。

ヘッダー名 要素 説明
偽装
ExchangeImpersonation
クライアント アプリケーションが偽装しているユーザーを識別します。 このヘッダーは要求に適用されます。
MailboxCulture
MailboxCulture
RFC 3066 で定義されている "言語の識別用タグ" で定義されているカルチャを識別し、メールボックスにアクセスするために使用します。 このヘッダーは要求に適用されます。
RequestVersion
RequestServerVersion
操作要求のスキーマ バージョンを識別します。 このヘッダーは要求に適用されます。
ServerVersion
ServerVersionInfo
要求に応答したサーバーのバージョンを識別します。 このヘッダーは、応答に適用できます。

MarkAsJunk 操作要求の例: 受信拒否リストに送信者を追加する

次の MarkAsJunk 操作要求の例は、メールの送信者をブロックされた送信者リストに追加し、メールを迷惑メール フォルダーに移動する方法を示しています。 MarkAsJunk 操作は、一意の電子メール メッセージ識別子を受け入れて、ブロックされた送信者リストに追加された送信者を参照するために使用される電子メールを識別します。

注:

この記事のすべての項目識別子と変更キーは、読みやすくするために短縮されています。

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

要求 SOAP 本文には、次の要素が含まれています。

MarkAsJunk 操作の応答に成功しました

次の例は、MarkAsJunk 操作要求に対する応答が成功し、送信者をブロックされている送信者リストに追加し、電子メール メッセージを迷惑メール 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="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>

応答 SOAP 本文には、次の要素が含まれています。

MarkAsJunk 操作要求の例: 受信拒否リストから送信者を削除する

次の MarkAsJunk 操作要求の例は、受信拒否リストから電子メール メッセージの送信者を削除し、電子メール メッセージを受信トレイ フォルダーに移動する方法を示しています。 受信拒否リストから送信者を削除するには、ブロックされた送信者から送信された電子メール メッセージを保持する必要があります。 送信者の電子メール アドレスは、送信者によって送信された電子メール メッセージに関連付けられています。 参照メール メッセージがユーザーのメールボックスに存在しなくなった場合、ブロックされている送信者リストからの送信者の削除は成功しません。 メール メッセージを送信者に関連付けるために使用するアイテム識別子は、Exchange メールボックスに存在するアイテムに関連付ける必要があります。 クライアント アプリケーションから送信者のブロックを解除できるように、以前にブロックされた送信者によって送信されたアイテムを格納する非表示フォルダーを作成することをお勧めします。 アイテムが Exchange メールボックスから削除された場合、管理者は、Exchange 管理コンソールを使用して、ブロックされている送信者リストにアクセスしてリストから送信者を削除する必要があります。 Exchange 管理コンソールを使用してユーザーのブロックを解除する方法については、「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>

受信拒否リストから送信者を削除するための正常な応答は、受信拒否リストに送信者を追加するための応答と同じです。

要求 SOAP 本文には、次の要素が含まれています。

MarkAsJunk 操作エラー応答

次の例は、 MarkAsJunk 操作要求に対するエラー応答を示しています。 これは、アイテム識別子で指定された電子メール メッセージがメールボックスに存在しなくなった場合に、ブロックされた送信者リストに送信者を追加または削除する要求に対する応答です。

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

エラー応答 SOAP 本文には、次の要素が含まれています。

関連項目