UpdateInboxRules 操作

[アーティクル]
03/29/2023

UpdateInboxRules 操作は、指定した操作を適用することで、認証されたユーザーの受信トレイルールを更新します。 UpdateInboxRules は、受信トレイルールの作成、受信トレイルールの設定、受信トレイルールの削除に使用されます。

UpdateInboxRules 操作を使用すると、Exchange Web Services はクライアント側の送信規則を削除します。クライアント側の送信ルールは、クライアントのルールのフォルダー関連情報 (FAI) メッセージにのみ保存されます。 EWS は既定で、このルール FAI メッセージを削除します。これは、Outlook がこれを再作成するという前提に基づいて行われます。ただし、Outlook で再作成できるのは、拡張ルールとしても存在しているルールです。けれども、クライアント側の送信ルールは拡張ルールとして存在していません。その結果、これらのルールは失われます。ソリューションの設計時にこのことを考慮にするようお勧めします。

UpdateInboxRules (ルールの作成) 要求の例

Exchange Web サービスを使用して、Exchange ストア内のユーザーのメールボックスに受信トレイルールを作成できます。ルールを作成するには、 UpdateInboxRules 要素を CreateRuleOperation 要素と組み合わせて使用します。

説明

クライアントは要求 XML を構築し、サーバーに送信します。

コード

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
  <soap:Header>
    <t:RequestServerVersion Version ="Exchange2010_SP1"/>
  </soap:Header>
  <soap:Body>
      <m:UpdateInboxRules>
        <m:RemoveOutlookRuleBlob>true</m:RemoveOutlookRuleBlob>
        <m:Operations>
          <t:CreateRuleOperation>
            <t:Rule>
              <t:DisplayName>MoveInterestingToJunk</t:DisplayName>
              <t:Priority>1</t:Priority>
              <t:IsEnabled>true</t:IsEnabled>
              <t:Conditions>
                <t:ContainsSubjectStrings>
                  <t:String>Interesting</t:String>
                </t:ContainsSubjectStrings>
              </t:Conditions>
              <t:Exceptions />
              <t:Actions>
                <t:MoveToFolder>
                  <t:DistinguishedFolderId Id="junkemail" />
                </t:MoveToFolder>
              </t:Actions>
            </t:Rule>
          </t:CreateRuleOperation>
        </m:Operations>
      </m:UpdateInboxRules>
  </soap:Body>
</soap:Envelope>

Comments

次の使用例は、電子メールの件名に "Interesting" と等しい文字列が含まれている場合に、電子メールメッセージを迷惑メールフォルダーに移動するルールを作成します。

要求要素

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

Operations 要素には、ルールを作成するための CreateRuleOperation 要素が含まれています。

UpdateInboxRules (ルールの作成) 応答の例

説明

次の Simple Object Access Protocol (SOAP) 本文の例は、ルールを作成する UpdateInboxRules 要求に対する正常な応答を示しています。

コード

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="14" 
        MinorVersion="1" 
        MajorBuildNumber="139" 
        MinorBuildNumber="0" Version="Exchange2010_SP1" 
        xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <UpdateInboxRulesResponse 
         ResponseClass="Success" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
    </UpdateInboxRulesResponse>
  </s:Body>
</s:Envelope>

成功した応答要素

応答では、次の要素が使用されます。

UpdateInboxRules (Set Rule) 要求の例

Exchange Web サービスを使用して、Exchange ストア内のユーザーのメールボックス内の受信トレイルールを変更できます。 UpdateInboxRules 要素を SetRuleOperation 要素と組み合わせて使用して、ルールを変更します。

説明

クライアントは要求 XML を構築し、サーバーに送信します。

コード

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
  <soap:Header>
    <t:RequestServerVersion Version ="Exchange2010_SP1"/>
  </soap:Header>
  <soap:Body>
      <m:UpdateInboxRules>
        <m:RemoveOutlookRuleBlob>true</m:RemoveOutlookRuleBlob>
        <Operations xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
          <SetRuleOperation xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
            <Rule>
              <RuleId>Nh8AAAAwW/w=</RuleId>
              <DisplayName>(Modified) This is Junk</DisplayName>
              <Priority>1</Priority>
              <IsEnabled>true</IsEnabled>
              <Conditions>
                <ContainsSubjectStrings>
                  <String>Interesting</String>
                </ContainsSubjectStrings>
              </Conditions>
              <Actions>
                <MoveToFolder>
                  <FolderId Id="AAMkADQ1YTE1" ChangeKey="AQAAAA==" />
                </MoveToFolder>
              </Actions>
            </Rule>
          </SetRuleOperation>
        </Operations>
      </m:UpdateInboxRules>
  </soap:Body>
</soap:Envelope>

Comments

次の使用例は、表示名を "(Modified) This is Junk" に変更します。

注:

FolderId 要素の Id 属性と ChangeKey 属性の値は、読みやすくするために短縮されています。

要求要素

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

Operations 要素には、ルールを変更するための SetRuleOperation 要素が含まれています。

UpdateInboxRules (Set Rule) 応答の例

説明

次の Simple Object Access Protocol (SOAP) 本文の例は、ルールを変更する UpdateInboxRules 要求に対する正常な応答を示しています。

コード

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="14" 
        MinorVersion="1" 
        MajorBuildNumber="139" 
        MinorBuildNumber="0" 
        Version="Exchange2010_SP1" 
        xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <UpdateInboxRulesResponse 
          ResponseClass="Success" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
    </UpdateInboxRulesResponse>
  </s:Body>
</s:Envelope>

成功した応答要素

応答では、次の要素が使用されます。

UpdateInboxRules (Delete Rule) 要求の例

Exchange Web サービスを使用して、Exchange ストア内のユーザーのメールボックス内の受信トレイルールを削除できます。ルールを削除するには、 UpdateInboxRules を DeleteRuleOperation 要素と組み合わせて使用します。

説明

クライアントは要求 XML を構築し、サーバーに送信します。

コード

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
  <soap:Header>
    <t:RequestServerVersion Version ="Exchange2010_SP1"/>
  </soap:Header>
  <soap:Body>
      <m:UpdateInboxRules>
        <m:RemoveOutlookRuleBlob>true</m:RemoveOutlookRuleBlob>
        <m:Operations>
          <t:DeleteRuleOperation>
            <t:RuleId>Nh8AAAAwW/U=</t:RuleId>
          </t:DeleteRuleOperation>
        </m:Operations>
      </m:UpdateInboxRules>
  </soap:Body>
</soap:Envelope>

Comments

次の使用例は、既存の識別されたルールを削除します。

要求要素

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

Operations 要素には、ルールを削除する DeleteRuleOperation 要素が含まれています。

UpdateInboxRules (Delete Rule) 応答の例

説明

次の Simple Object Access Protocol (SOAP) 本文の例は、ルールを削除する UpdateInboxRules 要求に対する正常な応答を示しています。

コード

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="14" 
        MinorVersion="1" 
        MajorBuildNumber="139" 
        MinorBuildNumber="0" 
        Version="Exchange2010_SP1" 
        xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <UpdateInboxRulesResponse ResponseClass="Success" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
    </UpdateInboxRulesResponse>
  </s:Body>
</s:Envelope>

成功した応答要素

応答では、次の要素が使用されます。

次の方法で共有

UpdateInboxRules 操作

UpdateInboxRules (ルールの作成) 要求の例

説明

コード

Comments

要求要素

UpdateInboxRules (ルールの作成) 応答の例

説明

コード

成功した応答要素

UpdateInboxRules (Set Rule) 要求の例

説明

コード

Comments

要求要素

UpdateInboxRules (Set Rule) 応答の例

説明

コード

成功した応答要素

UpdateInboxRules (Delete Rule) 要求の例

説明

コード

Comments

要求要素

UpdateInboxRules (Delete Rule) 応答の例

説明

コード

成功した応答要素

関連項目

フィードバック

その他のリソース