Exchange における EWS でのメールのプロパティと要素Email properties and elements in EWS in Exchange

Exchange で EWS マネージ API または EWS を使用して、メール メッセージで取得できるファースト クラスと他のプロパティと要素について説明します。Learn about the first-class and other properties and elements that you can get on email messages by using the EWS Managed API or EWS in Exchange.

メール メッセージには 50 を超えるプロパティがあるので、検索する場所が分からないと、必要なプロパティを必要な時に取得する場合に混乱する可能性があります。Email messages have more than 50 properties, and getting the ones you want, when you want them, can be confusing if you don't know where to look. メールのプロパティと要素の操作方法を理解するうえで最も重要なことは、主な取得方法と操作によって返されるファースト クラスのプロパティおよび要素のセットにどれが含まれているかということです。The most important thing to know about working with email properties and elements is which are included in the set of first-class properties and elements that is returned by each of the main retrieval methods and operations. 返されるファースト クラスのプロパティのセットは、どの方法で取得するかによって異なります。The set of first-class properties that is returned varies based on the retrieval method that you use. また、BaseShape EWS 要素の AllProperties 値に惑わされないことも重要です。この値は EWS マネージ API の BasePropertySet.FirstClassMessageProperties 列挙値に対応します。It's also important not to be fooled by the AllProperties value of the BaseShape EWS element, which corresponds to the BasePropertySet.FirstClassMessageProperties enumeration value in the EWS Managed API. この値には、実際にすべてのプロパティが含まれているわけではなく、ファースト クラスのプロパティのみが含まれます。This value doesn't actually include all properties, it only includes the first-class properties.

メール メッセージのファースト クラスのプロパティと要素First-class properties and elements for email messages

EWS マネージ API の EmailMessage.Bind メソッドと EWS の GetItem 操作によって返されるファースト クラスのプロパティと要素のセットは、EWS マネージ API の ExchangeService.FindItems メソッドと EWS の FindItem 操作によって返されるファースト クラスのプロパティと要素のセットとは、若干異なります。The set of first-class properties and elements that are returned by the EWS Managed API EmailMessage.Bind method and the EWS GetItem operation is slightly different than the set of first-class properties and elements that is returned by the EWS Managed API ExchangeService.FindItems method and the EWS FindItem operation. FindItems メソッドと FindItem 操作によって返されるファースト クラスのプロパティは、Bind メソッドと GetItem 操作によって返されるプロパティのサブセットです。The first-class properties returned by the FindItems method and FindItem operation are a subset of the properties returned by the Bind method and GetItem operation. 表 1 に、Bind メソッドと GetItem 操作によって返されるすべてのファースト クラスのプロパティと、そのうちどのプロパティが FindItems メソッドまたは FindItem 操作によって返されないのかを示します。Table 1 lists all the first-class properties returned by the Bind method and the GetItem operation, and specifies which of those are not returned by the FindItems method or FindItem operation. ToRecipientsCcRecipientsBccRecipients などの他のプロパティや要素を取得するように FindItems メソッドまたは FindItem 操作を拡張することはできません。Note that you cannot extend the FindItems method or the FindItem operation to retrieve additional properties and elements such as ToRecipients, CcRecipients, and BccRecipients. これらの値を取得するには、FindItems メソッドまたは FindItem 操作を使用してメールのアイテム ID を取得してから、Bind メソッドまたは GetItem 操作を使用して必要なプロパティを取得します。If you need to retrieve those values, use the FindItems method or the FindItem operation to get the item IDs of the emails, and then use the Bind method or the GetItem operation, to retrieve the required properties. Bind メソッドまたは FindItems メソッドを使用してアイテムを取得する方法を示すコード例については、「EWS マネージ API を使用してアイテムを取得する」を参照してください。For code examples that show how to retrieve items by using the Bind or the FindItems method, see Get an item by using the EWS Managed API. GetItem 操作または FindItem 操作を使用してアイテムを取得する方法を示すコード例については、「EWS を使用してアイテムを取得する」を参照してください。For code examples that show how to retrieve items by using the GetItem or FindItem operations, see Get an item by using EWS.

次の表に、応答で表示される順序でファースト クラスのプロパティと要素を記載します。The first-class properties and elements are listed in the following table in the order in which they appear in a response.

表 1. ファースト クラスのメールのプロパティと要素Table 1. First-class email properties and elements

EWS マネージ API のプロパティEWS Managed API property EWS の要素EWS element ****FindItems** メソッドまたは FindItem 操作のファースト クラスのプロパティか**First-class property for the FindItems method or the FindItem operation? 読み取り/書き込み、または読み取り専用Read-write or read-only
IdId
ItemIdItemId
はいYes
読み取り専用Read-only
ParentFolderIdParentFolderId
ParentFolderIdParentFolderId
はいYes
読み取り専用Read-only
ItemClassItemClass
ItemClassItemClass
はいYes
読み取り/書き込みRead-write
SubjectSubject
SubjectSubject
はいYes
読み取り/書き込みRead-write
SensitivitySensitivity
SensitivitySensitivity
はいYes
読み取り専用Read-only
BodyBody
BodyBody
いいえNo
読み取り/書き込みRead-write
AttachmentsAttachments
AttachmentsAttachments
いいえNo
読み取り/書き込みRead-write
DateTimeReceivedDateTimeReceived
DateTimeReceivedDateTimeReceived
はいYes
読み取り専用Read-only
SizeSize
SizeSize
はいYes
読み取り専用Read-only
CategoriesCategories
CategoriesCategories
いいえNo
読み取り/書き込みRead-write
ImportanceImportance
ImportanceImportance
はいYes
読み取り/書き込みRead-write
InReplyToInReplyTo
InReplyToInReplyTo
はいYes
読み取り/書き込みRead-write
IsSubmittedIsSubmitted
IsSubmittedIsSubmitted
はいYes
読み取り専用Read-only
IsDraftIsDraft
IsDraftIsDraft
はいYes
読み取り専用Read-only
IsFromMeIsFromMe
IsFromMeIsFromMe
はいYes
読み取り専用Read-only
IsResendIsResend
IsResendIsResend
はいYes
読み取り専用Read-only
IsUnmodifiedIsUnmodified
IsUnmodifiedIsUnmodified
はいYes
読み取り専用Read-only
InternetMessageHeadersInternetMessageHeaders
InternetMessageHeadersInternetMessageHeaders
いいえNo
読み取り専用Read-only
DateTimeSentDateTimeSent
DateTimeSentDateTimeSent
はいYes
読み取り専用Read-only
DateTimeCreatedDateTimeCreated
DateTimeCreatedDateTimeCreated
はいYes
読み取り専用Read-only
AllowedResponseActionsAllowedResponseActions
ResponseObjectsResponseObjects
いいえNo
読み取り専用Read-only
ReminderDueByReminderDueBy
ReminderDueByReminderDueBy
はいYes
読み取り/書き込みRead-write
IsReminderSetIsReminderSet
ReminderIsSetReminderIsSet
はいYes
読み取り/書き込みRead-write
ReminderMinutesBeforeStartReminderMinutesBeforeStart
ReminderMinutesBeforeStartReminderMinutesBeforeStart
はいYes
読み取り/書き込みRead-write
DisplayCcDisplayCc
DisplayCcDisplayCc
はいYes
読み取り専用Read-only
DisplayToDisplayTo
DisplayToDisplayTo
はいYes
読み取り専用Read-only
HasAttachmentsHasAttachments
HasAttachmentsHasAttachments
はいYes
読み取り専用Read-only
CultureCulture
CultureCulture
はいYes
読み取り/書き込みRead-write
EffectiveRightsEffectiveRights
EffectiveRightsEffectiveRights
はいYes
読み取り専用Read-only
LastModifiedNameLastModifiedName
LastModifiedNameLastModifiedName
はいYes
読み取り専用Read-only
LastModifiedTimeLastModifiedTime
LastModifiedTimeLastModifiedTime
はいYes
読み取り専用Read-only
IsAssociatedIsAssociated
IsAssociatedIsAssociated
はいYes
読み取り/書き込みRead-write
WebClientReadFormQueryStringWebClientReadFormQueryString
WebClientReadFormQueryStringWebClientReadFormQueryString
はいYes
読み取り専用Read-only
WebClientEditFormQueryStringWebClientEditFormQueryString
WebClientEditFormQueryStringWebClientEditFormQueryString
はいYes
読み取り専用Read-only
ConversationIdConversationId
ConversationIdConversationId
はいYes
読み取り専用Read-only
FlagFlag
FlagFlag
はいYes
読み取り/書き込みRead-write
InstanceKeyInstanceKey
InstanceKeyInstanceKey
はいYes
読み取り専用Read-only
EntityExtractionResultEntityExtractionResult
EntityExtractionResultEntityExtractionResult
いいえNo
読み取り専用Read-only
SenderSender
SenderSender
はいYes
読み取り/書き込みRead-write
ToRecipientsToRecipients
ToRecipientsToRecipients
いいえNo
読み取り専用Read-only
CcRecipientsCcRecipients
CcRecipientsCcRecipients
いいえNo
読み取り専用Read-only
BccRecipientsBccRecipients
BccRecipientsBccRecipients
いいえNo
読み取り専用Read-only
IsReadReceiptRequestedIsReadReceiptRequested
IsReadReceiptRequestedIsReadReceiptRequested
はいYes
読み取り/書き込みRead-write
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
IsDeliveryReceiptRequestedIsDeliveryReceiptRequested
はいYes
読み取り/書き込みRead-write
ConversationIndexConversationIndex
ConversationIndexConversationIndex
はいYes
読み取り専用Read-only
ConversationTopicConversationTopic
ConversationTopicConversationTopic
はいYes
読み取り専用Read-only
FromFrom
FromFrom
はいYes
読み取り/書き込みRead-write
InternetMessageIdInternetMessageId
InternetMessageIdInternetMessageId
はいYes
読み取り専用Read-only
IsReadIsRead
IsReadIsRead
はいYes
読み取り/書き込みRead-write
IsResponseRequestedIsResponseRequested
IsResponseRequestedIsResponseRequested
はいYes
読み取り/書き込みRead-write
ReplyToReplyTo
ReplyToReplyTo
いいえNo
読み取り専用Read-only
ReferencesReferences
ReferencesReferences
はいYes
読み取り/書き込みRead-write
ReceivedByReceivedBy
ReceivedByReceivedBy
はいYes
読み取り専用Read-only
ReceivedRepresentingReceivedRepresenting
ReceivedRepresentingReceivedRepresenting
はいYes
読み取り専用Read-only

メール メッセージのその他のプロパティと要素Other properties and elements for email messages

すべての重要なメールのプロパティと要素が、ファースト クラスのプロパティと要素であるわけではありません。Not all important email properties and elements are first-class properties and elements. その他のプロパティまたは要素を取得するには、それらを PropertySet に追加するか (EWS マネージ API を使用している場合)、またはプロパティ パスを使用して EWS 操作呼び出しに追加する必要があります。To get the other properties or elements, you need to add them to your PropertySet if you're using the EWS Managed API, or use a property path to add them to your EWS operation call. たとえば、メッセージのテキスト本文と MIME コンテンツを取得するには、Bind または Load メソッドで示すように PropertySet を作成します。For example, to retrieve the text body and the MIME content of a message, create your PropertySet as shown for the Bind or Load method.

PropertySet(BasePropertySet.IdOnly, ItemSchema.TextBody, ItemSchema.MimeContent);

または、EWS を使用している場合は、次に示すように、該当する要素を GetItem 操作要求の AdditionalProperties 要素に追加します。Or if you're using EWS, add the elements to the AdditionalProperties element in your GetItem operation request, as shown.

<t:AdditionalProperties>
    <t:FieldURI FieldURI="item:TextBody" />
    <t:FieldURI FieldURI="item:MimeContent" />
</t:AdditionalProperties>

EWS マネージ API の ServiceObject オブジェクトから継承されている EmailMessage プロパティを、Bind メソッドのプロパティ セットに含めることはできません。ただし、すべての ServiceObject プロパティは EmailMessage オブジェクト上で読み取ることができ、Bind メソッドによって取得されます。EmailMessage properties inherited from the EWS Managed API ServiceObject object cannot be included in a property set for the Bind method; however, all the ServiceObject properties are readable on the EmailMessage object and are retrieved by the Bind method.

表 2. メールのその他のプロパティと要素Table 2. Other email properties and elements

EWS マネージ API のプロパティEWS Managed API property EWS の要素EWS element 読み取り/書き込み、または読み取り専用Read-write or read-only
ArchiveTagArchiveTag
ArchiveTagArchiveTag
読み取り/書き込みRead-write
ExtendedPropertiesExtendedProperties
ExtendedPropertyExtendedProperty
読み取り専用Read-only
IconIndexIconIndex
IconIndexIconIndex
読み取り専用Read-only
IsAttachmentIsAttachment
使用不可Not available
読み取り専用Read-only
IsDirtyIsDirty
使用不可Not available
読み取り専用Read-only
IsNewIsNew
使用不可Not available
読み取り専用Read-only
ItemItem
ItemItem
読み取り専用Read-only
MimeContentMimeContent
MimeContentMimeContent
読み取り専用Read-only
利用不可Not available
MimeContentUTF8MimeContentUTF8
読み取り専用Read-only
NormalizedBodyNormalizedBody
NormalizedBodyNormalizedBody
読み取り専用Read-only
PolicyTagPolicyTag
PolicyTagPolicyTag
読み取り/書き込みRead-write
PreviewPreview
PreviewPreview
読み取り/書き込みRead-write
RetentionDateRetentionDate
RetentionDateRetentionDate
読み取り専用Read-only
SchemaSchema
使用不可Not available
読み取り専用Read-only
ServiceService
使用不可Not available
読み取り専用Read-only
StoreEntryIdStoreEntryId
StoreEntryIdStoreEntryId
読み取り専用Read-only
TextBodyTextBody
TextBodyTextBody
読み取り専用Read-only
UniqueBodyUniqueBody
UniqueBodyUniqueBody
読み取り専用Read-only

関連項目See also