UpdateInboxRules 操作
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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://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="https://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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
<SetRuleOperation xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://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="https://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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://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="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
</UpdateInboxRulesResponse>
</s:Body>
</s:Envelope>
成功した応答要素
応答では、次の要素が使用されます。
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示