eventMessage リソースの種類

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

名前空間: microsoft.graph

メッセージは会議出席依頼、キャンセル、応答 (承諾、仮受諾、辞退のいずれか) を表します。

eventMessage エンティティは message から派生したものです。 eventMessage は、 eventMessageRequest と eventMessageResponse の基本型です。 meetingMessageType プロパティはイベントメッセージの種類を特定します。

開催者またはアプリが会議出席依頼を送信すると、会議出席依頼は、meetingRequest の meetingMessageType を持つ eventMessage インスタンスとして招待者のメールボックスに到着します。さらに、Outlook は招待者の予定表に イベント インスタンスを自動的に作成し、 showAs プロパティを仮のものとして作成します。

招待者のメールボックス内の関連付けられているイベントのプロパティを取得するには、このイベントメッセージの取得の例に示すように、アプリで eventMessage のイベント ナビゲーションプロパティを使用できます。また、アプリは、イベントを承諾、仮承諾、または拒否することで、招待者の代わりにプログラムでイベントに応答することもできます。

会議出席依頼とは別に、イベント開催者が会議をキャンセルした結果として、または会議出席依頼に応答した招待者の結果として、 eventMessage インスタンスが招待者のメールボックスに見つかります。アプリはメッセージ上と同様にイベントメッセージ上でも動作しますが、わずかな違いがあります。

メソッド

メソッド	戻り値の型	説明
eventMessage の取得	eventMessage	eventMessage オブジェクトのプロパティとリレーションシップを読み取ります。
更新する	eventMessage	eventMessage オブジェクトを更新します。
削除	なし	eventMessage オブジェクトを削除します。
copy	message	メッセージをフォルダーにコピーします。
createForward	message	転送メッセージの下書きを作成します。その後、下書きを更新または送信できます。
createReply	message	返信メッセージの下書きを作成します。その後、下書きを更新または送信できます。
createReplyAll	message	全員に返信メッセージの下書きを作成します。その後、下書きを更新または送信できます。
forward	なし	メッセージを転送します。その後、メッセージは送信済みアイテムフォルダーに保存されます。
move	message	メッセージをフォルダーに移動します。これにより、宛先フォルダーにメッセージの新しいコピーが作成されます。
返信	なし	メッセージの送信者に返信します。その後、メッセージは [送信済みアイテム] フォルダーに保存されます。
replyAll	なし	メッセージの受信者すべてに返信します。その後、メッセージは [送信済みアイテム] フォルダーに保存されます。
send	なし	以前に作成したメッセージの下書きを送信します。その後、メッセージは送信済みアイテムフォルダーに保存されます。
添付ファイル
添付ファイルを一覧表示する	attachment コレクション	eventMessage のすべての添付ファイルを取得します。
添付ファイルを追加する	attachment	添付ファイルコレクションへの投稿により、eventMessage に新しい添付ファイルを追加します。
オープン拡張機能
Create open extension	openTypeExtension	オープン拡張機能を作成し、リソースの新規または既存のインスタンスのカスタムプロパティを追加します。
オープン拡張機能を取得する	openTypeExtension コレクション	名前や完全修飾名によって識別されたオープン拡張機能オブジェクトを 1 つまたは複数取得します。
拡張プロパティ
単一値の拡張プロパティを作成する	eventMessage	新規または既存の eventMessage に、1 つ以上の単一値の拡張プロパティを作成します。
単一値の拡張プロパティを持つ eventMessage の取得	eventMessage	`$expand` または `$filter` を使用して、単一値の拡張プロパティを含む eventMessage を取得します。
複数値の拡張プロパティを作成する	eventMessage	新規または既存の eventMessage に、1 つ以上の複数値の拡張プロパティを作成します。
複数値の拡張プロパティを持つ eventMessage の取得	eventMessage	`$expand` を使用して、複数値の拡張プロパティを含む eventMessage を取得します。

プロパティ

プロパティ	型	説明
bccRecipients	recipient collection	メッセージの BCC 受信者。
body	itemBody	メッセージの本文。 HTML 形式またはテキスト形式にできます。
bodyPreview	String	メッセージ本文の最初の 255 文字。テキスト形式です。
categories	String collection	メッセージに関連付けられたカテゴリ。
ccRecipients	recipient collection	メッセージの CC 受信者。
changeKey	String	メッセージのバージョン。
conversationId	String	電子メールが属している会話の ID。
conversationIndex	Edm.Binary	会話内のメッセージの位置を示します。
createdDateTime	DateTimeOffset	メッセージが作成された日時。
flag	followUpFlag	メッセージのステータス、開始日、期限、または完了日を示すフラグ値。
from	recipient	メッセージの送信元のメールボックスの所有者。ほとんどの場合、この値は sender プロパティと同じです。ただし、共有または委任のシナリオは除きます。この値は、実際に使用されているメールボックスに対応している必要があります。メッセージのfrom プロパティと sender プロパティの設定に関する詳細情報を参照してください。
hasAttachments	ブール値	メッセージに添付ファイルがあるかどうかを示します。
id	String	イベントメッセージの一意識別子。既定では、この値は、アイテムをあるコンテナー (フォルダーや予定表など) から別のコンテナーに移動したときに変更されます。この動作を変更するには、`Prefer: IdType="ImmutableId"` ヘッダーを使用します。詳細については「Outlook リソースの不変識別子を取得する」を参照してください。読み取り専用。
importance	String	メッセージの重要度: `low`、`normal`、`high`。
inferenceClassification	String	使用可能な値は、 `focused`、 `other`です。
internetMessageHeaders	internetMessageHeader コレクション	RFC5322 によって定義された、メッセージヘッダーのコレクション。メッセージが送信者から受信者に到達するまでに辿ったネットワークパスの詳細を説明します。読み取り専用。
internetMessageId	String	RFC2822 によって指定された形式のメッセージ ID。
isDelegated	ブール型	この会議出席依頼に代理人がアクセスできる場合は True、それ以外の場合は false。既定値は false です。
isDeliveryReceiptRequested	Boolean	メッセージの開封確認メッセージが要求されているかどうかを示します。
isDraft	ブール値	メッセージが下書きかどうかを示します。メッセージがまだ送信されていなければ下書きです。
isRead	Boolean	メッセージが開封されたかどうかを示します。
isReadReceiptRequested	Boolean	メッセージの開封確認メッセージが要求されているかどうかを示します。
lastModifiedDateTime	DateTimeOffset	メッセージが最後に変更された日時。
meetingMessageType	meetingMessageType	イベントメッセージの種類: `none`、`meetingRequest`、`meetingCancelledmeetingAcceptedmeetingTenativelyAcceptedmeetingDeclined`。
parentFolderId	String	メッセージの親 mailFolder の一意識別子。
receivedDateTime	DateTimeOffset	メッセージが受信された日時です。
replyTo	recipient collection	返信時に使用される電子メールアドレス。
sender	recipient	メッセージを生成するために実際に使用されるアカウント。ほとんどの場合、この値は from プロパティと同じです。共有メールボックスからメッセージを送信するとき、共有予定表用に、または代理人としてこのプロパティを別の値に設定できます。いずれの場合でも、この値は、実際に使用されているメールボックスに対応している必要があります。メッセージのfrom プロパティと sender プロパティの設定に関する詳細情報を参照してください。
sentDateTime	DateTimeOffset	メッセージが送信された日時。
subject	String	メッセージの件名。
toRecipients	recipient collection	メッセージの宛先。
uniqueBody	itemBody	現在のメッセージに特有のメッセージの本文の一部。
webLink	String	Outlook on the web でメッセージを開く URL。 URL の末尾に ispopout 引数を付加して、メッセージの表示方法を変更できます。 ispopout が存在しない、または 1 に設定されている場合は、メッセージがポップアウトウィンドウに表示されます。 ispopout が 0 に設定されている場合、ブラウザーの Outlook on the web レビューウィンドウにメッセージが表示されます。 Outlook on the web のメールボックスにログインしている場合、ブラウザーでメッセージが開きます。まだブラウザーでログインしていない場合、ログインするように求められます。この URL には、iFrame 内からアクセスできません。

リレーションシップ

リレーションシップ	型	説明
attachments	attachment コレクション	読み取り専用です。 Null 許容型。
event	event	イベントメッセージに関連付けられたイベント。参加者または部屋リソースの前提は、会議出席依頼イベントメッセージが届いたときにイベントを含む予定表を自動的に更新するようにカレンダーアテンダントが設定されていることです。ナビゲーションプロパティ。読み取り専用。
extensions	extension コレクション	eventMessage に対して定義されているオープン拡張機能のコレクション。読み取り専用。 Null 許容型。
multiValueExtendedProperties	multiValueLegacyExtendedProperty collection	eventMessage に対して定義された、複数値の拡張プロパティのコレクション。読み取り専用。 Null 許容型。
singleValueExtendedProperties	singleValueLegacyExtendedProperty collection	eventMessage に対して定義された、単一値の拡張プロパティのコレクション。読み取り専用。 Null 許容型。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "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",
  "event": { "@odata.type": "microsoft.graph.event" },
  "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",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "meetingMessageType": "String",
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string"
}