GetConversationItems 操作
GetConversationItems 操作に関する情報を検索します。
GetConversationItems 操作は、会話内のノードに編成された項目の 1 つ以上のセットを取得します。
この操作は Exchange Server 2013 で導入されました。
GetConversationItems 操作の使用
GetConversationItems 操作を使用して、プライマリ メールボックスとアーカイブ メールボックスの両方の会話内のアイテムを取得できます。
GetConversationItems 操作 SOAP ヘッダー
GetConversationItems 操作では、次の表に示す SOAP ヘッダーを使用できます。
| ヘッダー名 | 要素 | 説明 |
|---|---|---|
| 偽装 |
ExchangeImpersonation |
クライアント アプリケーションが偽装しているユーザーを識別します。 このヘッダーは要求に適用されます。 |
| RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 この要素の最小値は Exchange2013 です。 このヘッダーは要求に適用されます。 |
| ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 このヘッダーは、応答に適用できます。 |
GetConversationItems 操作要求の例: 1 つの会話で項目を取得する
GetConversationItems 操作要求の次の例は、削除済みアイテムフォルダーと下書きフォルダーにあるアイテムを除き、1 つの会話内のすべての会話アイテムを取得する方法を示しています。 応答で返される各項目には、アイテム識別子、件名、およびアイテムがメールボックスで受信された時刻が含まれます。
注:
この記事のすべての項目識別子と変更キーは、読みやすくするために短縮されています。
<?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:GetConversationItems>
<m:ItemShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:Subject" />
<t:FieldURI FieldURI="item:DateTimeReceived" />
</t:AdditionalProperties>
</m:ItemShape>
<m:FoldersToIgnore>
<t:DistinguishedFolderId Id="deleteditems" />
<t:DistinguishedFolderId Id="drafts" />
</m:FoldersToIgnore>
<m:SortOrder>TreeOrderDescending</m:SortOrder>
<m:Conversations>
<t:Conversation>
<t:ConversationId Id="AAQkADEzOTExYjJkakJCs=" />
</t:Conversation>
</m:Conversations>
</m:GetConversationItems>
</soap:Body>
</soap:Envelope>
GetConversationItems 要求のこの例には、次のオプションは含まれていません。
MaxItemsToReturn 要素。応答で返される項目の最大数を設定します。
メールボックス スコープを設定する MailboxScope 要素。 GetConversationItems 操作をプライマリ メールボックス、アーカイブ メールボックス、または両方のメールボックスで実行するかどうかを示します。
SyncState (base64Binary) 要素。同期状態を設定して、会話内で新規または更新された会話項目のみを取得します。 この要素は、会話ごとに設定されます。
要求 SOAP 本文には、次の要素が含まれています。
GetConversationItems 操作の応答に成功しました
次の例は、1 つの会話で項目を 取得するための GetConversationItems 操作要求に対する正常な応答を示しています。
<?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:GetConversationItemsResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetConversationItemsResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Conversation>
<t:ConversationId Id="AAQkADEzOTExYjJkakJCs=" />
<t:SyncState>AQIAAABNVkUwAgIAAABhHqHUAwIAAABNVkUxBAIAAABhHqHfBAIAAABhHqHV</t:SyncState>
<t:ConversationNodes>
<t:ConversationNode>
<t:InternetMessageId>6a4838fa804045e09d40c1a39b9ea916@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>15a56698d503438fbdaa18186d5b81b7@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkADEzOTQrAABhHqHfAAA=" ChangeKey="CQAAABYAAACYAABhPpaq" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T18:42:27Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>2695d2b837954d68846b0c30491f5af1@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>15a56698d503438fbdaa18186d5b81b7@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkADEzOTExYjJkLTYxZDAt" ChangeKey="CQAAABQrAABhPpaP" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:38:26Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>15a56698d503438fbdaa18186d5b81b7@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>d3113e59c89c4288ae13100d033f8dbc@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkADEzOTFNVkUxAAA=" ChangeKey="CQAAABY4QrAABhPvYK" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:37:00Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>d3113e59c89c4288ae13100d033f8dbc@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>189b712056c2430dbce334b40496ad00@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkm4QrAABhHqHUAAA=" ChangeKey="CQAAABQrAABhPpaN" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:37:05Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>189b712056c2430dbce334b40496ad00@contoso.com</t:InternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkArAABNVkUwAAA=" ChangeKey="CQAAABm4QrAABhPvYJ" />
<t:Subject>Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:36:00Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
</t:ConversationNodes>
</m:Conversation>
</m:GetConversationItemsResponseMessage>
</m:ResponseMessages>
</m:GetConversationItemsResponse>
</s:Body>
</s:Envelope>
以降の GetConversationItems 操作要求に対して SyncState を保存することをお勧めします。
応答 SOAP 本文には、次の要素が含まれています。
GetConversationItems 操作エラー応答
次の例は、 GetConversationItems 操作要求に対するエラー応答を示し、メールボックスに存在しなくなったスレッド内のアイテムを取得するか、すべての会話アイテムが無視されるフォルダーに配置されています。
<?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="556" MinorBuildNumber="8" 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:GetConversationItemsResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetConversationItemsResponseMessage 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:GetConversationItemsResponseMessage>
</m:ResponseMessages>
</m:GetConversationItemsResponse>
</s:Body>
</s:Envelope>