eventMessage リソースの種類eventMessage resource type


Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

メッセージは会議出席依頼、キャンセル、応答 (承諾、仮受諾、辞退のいずれか) を表します。A message that represents a meeting request, cancellation, or response (which can be one of the following: acceptance, tentative acceptance, or decline).

eventMessage エンティティは message から派生したものです。The eventMessage entity is derived from message. Eventmessageは、 eventmessageventMessageResponseおよびの基本型です。eventMessage is the base type for eventMessageRequest and eventMessageResponse. meetingMessageType プロパティはイベント メッセージの種類を特定します。The meetingMessageType property identifies the type of the event message.

開催者またはアプリが会議出席依頼を送信すると、会議出席依頼は会議出席依頼の会議のmessagetypeを使用して、招待者のメールボックスにeventmessageインスタンスとして送られます。When an organizer or app sends a meeting request, the meeting request arrives in an invitee's mailbox as an eventMessage instance with the meetingMessageType of meetingRequest. さらに、Outlook は、[ showasプロパティが [の予定] のイベントインスタンスを招待者の予定表に自動的に作成します。In addition, Outlook automatically creates an event instance in the invitee's calendar, with the showAs property as tentative.

招待者のメールボックスにある関連イベントのプロパティを取得するには、このget イベントメッセージの例に示すように、アプリでeventmessageイベントナビゲーションプロパティを使用できます。To get the properties of the associated event in the invitee's mailbox, the app can use the event navigation property of the eventMessage, as shown in this get event message example. また、アプリは、イベントを承諾、承諾、または拒否することによって、プログラムによって招待者の代理でイベントに応答することもできます。The app can also respond to the event on behalf of the invitee programmatically, by accepting, tentatively accepting, or declining the event.

会議出席依頼とは別に、イベント開催者が会議をキャンセルした結果として、または開催者のメールボックスで、会議出席依頼への招待に応答したときにEventmessageインスタンスが検索されることがあります。Aside from a meeting request, an eventMessage instance can be found in an invitee's mailbox as the result of an event organizer cancelling a meeting, or in the organizer's mailbox as a result of an invitee responding to the meeting request. アプリはメッセージ上と同様にイベント メッセージ上でも動作しますが、わずかな違いがあります。An app can act on event messages in the same way as on messages with minor differences.

JSON 表記JSON representation

以下は、リソースの JSON 表記ですHere is a JSON representation of the resource

  "bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "changeKey": "string",
  "conversationId": "string",
  "conversationIndex": "String (binary)",
  "createdDateTime": "DateTimeOffset",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "string (identifier)",
  "importance": "String",
  "inferenceClassification": "String",
  "internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
  "internetMessageId": "String",
  "isAllDay": "Boolean",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isOutOfDate": "Boolean",
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "location": {"@odata.type": "microsoft.graph.location"},
  "meetingMessageType": {"@odata.type": "microsoft.graph.meetingMessageType"},
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "type": "string",
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "UnsubscribeData": "string",
  "UnsubscribeEnabled": true,
  "webLink": "string"


プロパティProperty Type 説明Description
bccRecipientsbccRecipients recipient collectionrecipient collection メッセージの BCC 受信者。The Bcc: recipients for the message.
bodybody itemBodyitemBody メッセージの本文。HTML 形式またはテキスト形式にできます。The body of the message. It can be in HTML or text format.
bodyPreviewbodyPreview StringString メッセージ本文の最初の 255 文字。テキスト形式です。The first 255 characters of the message body. It is in text format.
categoriescategories String collectionString collection メッセージに関連付けられたカテゴリ。The categories associated with the message.
ccRecipientsccRecipients recipient collectionrecipient collection メッセージの CC 受信者。The Cc: recipients for the message.
changeKeychangeKey StringString メッセージのバージョン。The version of the message.
conversationIdconversationId StringString 電子メールが属している会話の ID。The ID of the conversation the email belongs to.
conversationIndexconversationIndex Edm.BinaryEdm.Binary 会話内でのメッセージの位置を示します。Indicates the position of the message within the conversation.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset メッセージが作成された日時。The date and time the message was created.
endDateTimeendDateTime dateTimeTimeZonedateTimeTimeZone 要求された会議の終了時刻。The end time of the requested meeting.
flagflag followUpFlagfollowUpFlag メッセージのステータス、開始日、期限、または完了日を示すフラグ値。The flag value that indicates the status, start date, due date, or completion date for the message.
fromfrom recipientrecipient メッセージのメールボックス所有者と送信者。The mailbox owner and sender of the message.
hasAttachmentshasAttachments ブール値Boolean メッセージに添付ファイルがあるかどうかを示します。Indicates whether the message has attachments.
idid StringString メッセージの一意識別子。Unique identifier for the message. 既定では、アイテムが1つのコンテナー (フォルダーや予定表など) から別のコンテナーに移動すると、この値は変更されます。By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. この動作を変更するにはPrefer: IdType="ImmutableId" 、ヘッダーを使用します。To change this behavior, use the Prefer: IdType="ImmutableId" header. 詳細については、「 Outlook リソースの不変識別子を取得する」を参照してください。See Get immutable identifiers for Outlook resources for more information. 読み取り専用です。既定では、アイテムが1つのコンテナー (フォルダーや予定表など) から別のコンテナーに移動すると、この値は変更されます。By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. この動作を変更するにはPrefer: IdType="ImmutableId" 、ヘッダーを使用します。To change this behavior, use the Prefer: IdType="ImmutableId" header. 詳細については、「 Outlook リソースの不変識別子を取得する」を参照してください。See Get immutable identifiers for Outlook resources for more information. Read-only.
importanceimportance StringString メッセージの重要度: lownormalhighThe importance of the message: low, normal, high.
inferenceClassificationinferenceClassification StringString 使用可能な値は、focusedother です。Possible values are: focused, other.
internetMessageHeadersinternetMessageHeaders internetMessageHeader コレクションinternetMessageHeader collection RFC5322 によって定義された、メッセージ ヘッダーのコレクション。メッセージが送信者から受信者に到達するまでに辿ったネットワーク パスの詳細を説明します。The collection of message headers, defined by RFC5322, that provide details of the network path taken by a message from the sender to the recipient. 読み取り専用。Read-only.
internetMessageIdinternetMessageId StringString RFC5322 で指定されている形式のメッセージ ID。The message ID in the format specified by RFC5322.
isAllDayisAllDay BooleanBoolean イベントが 1 日中続くかどうかを示します。Indicates whether the event lasts the entire day. このプロパティを調整するには、イベントのstartDateTimeおよびenddatetimeプロパティの調整も必要です。Adjusting this property requires adjusting the startDateTime and endDateTime properties of the event as well.
isDelegatedisDelegated ブール値Boolean この会議出席依頼が代理人がアクセスできる場合は True、それ以外の場合は false。True if this meeting request is accessible to a delegate, false otherwise. 既定値は false です。Default is false.
isDeliveryReceiptRequestedisDeliveryReceiptRequested ブール値Boolean メッセージの開封確認メッセージが要求されているかどうかを示します。Indicates whether a read receipt is requested for the message.
isDraftisDraft BooleanBoolean メッセージが下書きかどうかを示します。メッセージがまだ送信されていなければ下書きです。Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isOutOfDateisOutOfDate BooleanBoolean この会議出席要求がより新しい要求によって古くなっているかどうかを示します。Indicates whether this meeting request has been made out-of-date by a more recent request.
isReadisRead ブール値Boolean メッセージが開封されたかどうかを示します。Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested ブール値Boolean メッセージの開封確認メッセージが要求されているかどうかを示します。Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset メッセージが最後に変更された日時。The date and time the message was last changed.
locationlocation locationlocation 要求された会議の場所。The location of the requested meeting.
meetingMessageTypemeetingMessageType StringString イベント メッセージの種類: nonemeetingRequestmeetingCancelled``meetingAccepted``meetingTentativelyAccepted``meetingDeclinedThe type of event message: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined.
mentionsPreviewmentionsPreview mentionsPreviewmentionsPreview メッセージのメンションに関する情報。GET /メッセージ要求を処理するときに、サーバーはこのプロパティを設定して、既定で応答に含めます。メッセージにメンションがない場合、サーバーは null を返します。省略可能。Information about mentions in the message. When processing a GET /messages request, the server sets this property and includes it in the response by default. The server returns null if there are no mentions in the message. Optional.
parentFolderIdparentFolderId StringString メッセージの親 mailFolder の一意識別子。The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset メッセージが受信された日時です。The date and time the message was received.
recurrencerecurrence patternedRecurrencepatternedRecurrence 要求された会議の定期的なパターン。The recurrence pattern of the requested meeting.
replyToreplyTo recipient collectionrecipient collection 返信時に使用される電子メール アドレス。The email addresses to use when replying.
sendersender recipientrecipient メッセージを生成するために実際に使用されるアカウント。The account that is actually used to generate the message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset メッセージが送信された日時。The date and time the message was sent.
startDateTimestartDateTime dateTimeTimeZonedateTimeTimeZone 要求された会議の開始時刻。The start time of the requested meeting.
subjectsubject StringString メッセージの件名。The subject of the message.
toRecipientstoRecipients recipient collectionrecipient collection メッセージの宛先。The To: recipients for the message.
typetype StringString 要求された会議のsingleInstance種類occurence: exceptionseriesMaster、、。The type of requested meeting: singleInstance, occurence, exception, seriesMaster.
uniqueBodyuniqueBody itemBodyitemBody 現在のメッセージに特有のメッセージの本文の一部。The part of the body of the message that is unique to the current message.
UnsubscribeDataUnsubscribeData StringString List-Unsubscribe ヘッダーに基づいて解析された有効なエントリ。UnsubscribeEnabled プロパティが true の場合、これは List-Unsubscribe ヘッダー内の mail コマンドのデータです。The valid entries parsed from the List-Unsubscribe header. This is the data for the mail command in the List-Unsubscribe header if UnsubscribeEnabled property is true.
UnsubscribeEnabledUnsubscribeEnabled BooleanBoolean メッセージが登録解除に対して有効になっているかどうかを示します。list-Unsubscribe ヘッダーが rfc-2369 に準拠している場合、その値は True です。Indicates whether the message is enabled for unsubscribe. Its valueTrue if the list-Unsubscribe header conforms to rfc-2369.
webLinkwebLink StringString Outlook Web App でメッセージを開く URL。The URL to open the message in Outlook Web App.

URL の末尾に ispopout 引数を付加して、メッセージの表示方法を変更できます。ispopout が存在しない、または 1 に設定されている場合は、メッセージがポップアウト ウィンドウに表示されます。ispopout が 0 に設定されている場合、ブラウザーの Outlook Web App レビュー ウィンドウにメッセージが表示されます。You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook Web App review pane.

Outlook Web App のメールボックスにログインしている場合、ブラウザーでメッセージが開きます。まだブラウザーでログインしていない場合、ログインするように求められます。The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

この URL には、iFrame 内からアクセスできます。This URL can be accessed from within an iFrame.


リレーションシップRelationship Type 説明Description
attachmentsattachments attachment コレクションattachment collection メッセージのfileattachmentItemattachment、およびreferenceattachment添付ファイルのコレクションです。The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the message. 読み取り専用。Read-only. Null 許容型です。Nullable.
eventevent eventevent イベント メッセージに関連付けられたイベント。参加者または部屋リソースの前提は、会議出席依頼イベント メッセージが届いたときにイベントを含む予定表を自動的に更新するようにカレンダー アテンダントが設定されていることです。ナビゲーション プロパティ。読み取り専用。The event associated with the event message. The assumption for attendees or room resources is that the Calendar Attendant is set to automatically update the calendar with an event when meeting request event messages arrive. Navigation property. Read-only.
extensionsextensions extension コレクションextension collection eventMessage に対して定義されているオープン拡張機能のコレクション。読み取り専用。Null 許容型。The collection of open extensions defined for the eventMessage. Read-only. Nullable.
mentionsmentions mention コレクションmention collection メッセージのメンションのコレクション。createdDateTime で最新の日付順になっています。既定では、プロパティで を適用しない限り、 /メッセージはこのプロパティを返しません。A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty collectionmultiValueLegacyExtendedProperty collection eventMessage に対して定義された、複数値の拡張プロパティのコレクション。読み取り専用。Null 許容型。The collection of multi-value extended properties defined for the eventMessage. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection eventMessage に対して定義された、単一値の拡張プロパティのコレクション。読み取り専用。Null 許容型。The collection of single-value extended properties defined for the eventMessage. Read-only. Nullable.


メソッドMethod 戻り値の型Return Type 説明Description
eventMessage の取得Get eventMessage eventMessageeventMessage eventMessage オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of eventMessage object.
更新するUpdate eventMessageeventMessage eventMessage オブジェクトを更新します。Update eventMessage object.
DeleteDelete NoneNone eventMessage オブジェクトを削除します。Delete eventMessage object.
copycopy messagemessage メッセージをフォルダーにコピーします。Copy a message to a folder.
createForwardcreateForward messagemessage 転送メッセージの下書きを作成します。その後、下書きを更新または送信できます。Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply messagemessage 返信メッセージの下書きを作成します。その後、下書きを更新または送信できます。Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll messagemessage 全員に返信メッセージの下書きを作成します。その後、下書きを更新または送信できます。Create a draft of the Reply All message. You can then update or send the draft.
転送するforward なしNone メッセージを転送します。その後、メッセージは送信済みアイテム フォルダーに保存されます。Forward a message. The message is then saved in the Sent Items folder.
移動move messagemessage メッセージをフォルダーに移動します。これにより、宛先フォルダーにメッセージの新しいコピーが作成されます。Move a message to a folder. This creates a new copy of the message in the destination folder.
返信reply なしNone メッセージの送信者に返信します。その後、メッセージは送信済みアイテム フォルダーに保存されます。Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll なしNone メッセージの受信者すべてに返信します。その後、メッセージは送信済みアイテム フォルダーに保存されます。Reply to all recipients of a message. The message is then saved in the Sent Items folder.
送信send なしNone 以前に作成したメッセージの下書きを送信します。その後、メッセージは送信済みアイテム フォルダーに保存されます。Sends a previously created message draft. The message is then saved in the Sent Items folder.
unsubscribeunsubscribe なしNone List-Unsubscribe ヘッダー内の最初の mailto コマンドで指定されたデータとアドレスを使用して、メッセージを送信します。Send a message using the data and address specified in the first mailto command in the List-Unsubscribe header.
添付ファイルを一覧表示するList attachments attachment コレクションattachment collection eventMessage のすべての添付ファイルを取得します。Get all attachments on an eventMessage.
添付ファイルを追加するAdd attachment attachmentattachment 添付ファイル コレクションへの投稿により、eventMessage に新しい添付ファイルを追加します。Add a new attachment to an eventMessage by posting to the attachments collection.
オープン拡張機能Open extensions
オープン拡張機能を作成するCreate open extension openTypeExtensionopenTypeExtension オープン拡張機能を作成し、リソースの新規または既存のインスタンスのカスタム プロパティを追加します。Create an open extension and add custom properties in a new or existing instance of a resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 名前で識別されるオープン拡張機能を取得します。Get an open extension identified by name.
拡張プロパティExtended properties
単一値の拡張プロパティを作成するCreate single-value extended property eventMessageeventMessage 新規または既存の eventMessage に、1 つ以上の単一値の拡張プロパティを作成します。Create one or more single-value extended properties in a new or existing eventMessage.
単一値の拡張プロパティを持つ eventMessage の取得Get eventMessage with single-value extended property eventMessageeventMessage $expand または $filter を使用して、単一値の拡張プロパティを含む eventMessage を取得します。Get eventMessages that contain a single-value extended property by using $expand or $filter.
複数値の拡張プロパティを作成するCreate multi-value extended property eventMessageeventMessage 新規または既存の eventMessage に、1 つ以上の複数値の拡張プロパティを作成します。Create one or more multi-value extended properties in a new or existing eventMessage.
複数値の拡張プロパティを持つ eventMessage の取得Get eventMessage with multi-value extended property eventMessageeventMessage $expand を使用して、複数値の拡張プロパティを含む eventMessage を取得します。Get an eventMessage that contains a multi-value extended property by using $expand.