eventMessage リソースの種類
名前空間: microsoft.graph
メッセージは会議出席依頼、キャンセル、応答 (承諾、仮受諾、辞退のいずれか) を表します。
eventMessage エンティティは message から派生したものです。 eventMessage は、 eventMessageRequest と eventMessageResponse の基本型です。 meetingMessageType プロパティはイベント メッセージの種類を特定します。
開催者またはアプリが会議出席依頼を送信すると、会議出席依頼は、meetingRequest の meetingMessageType を持つ eventMessage インスタンスとして招待者のメールボックスに到着します。 さらに、Outlook は招待者の予定表に イベント インスタンスを自動的に作成し、 showAs プロパティを 仮のものとして作成します。
招待者のメールボックス内の関連付けられているイベントのプロパティを取得するには、このイベント メッセージの取得の例に示すように、アプリで eventMessage のイベント ナビゲーション プロパティを使用できます。 また、アプリは、イベントを承諾、仮承諾、または拒否することで、招待者の代わりにプログラムでイベントに応答することもできます。
会議出席依頼とは別に、イベント開催者が会議をキャンセルした結果として、または会議出席依頼に応答した招待者の結果として、 eventMessage インスタンスが招待者のメールボックスに見つかります。 アプリはメッセージ上と同様にイベント メッセージ上でも動作しますが、わずかな違いがあります。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| イベント メッセージを取得する | eventMessage | eventMessage オブジェクトのプロパティとリレーションシップを読み取ります。 |
| イベント メッセージを更新する | eventMessage | eventMessage オブジェクトを更新します。 |
| メッセージを削除する | なし | eventMessage オブジェクトを削除します。 |
| メッセージのコピー | message | メッセージをフォルダーにコピーします。 |
| メッセージを転送する下書きをCreateする | message | 転送メッセージの下書きを作成します。 その後、下書きを更新または送信できます。 |
| 返信する下書きをCreateする | message | 返信メッセージの下書きを作成します。 その後、下書きを更新または送信できます。 |
| 下書きを返信すべてにCreateする | message | 全員に返信メッセージの下書きを作成します。 その後、下書きを更新または送信できます。 |
| 転送メッセージ | なし | メッセージを転送します。 その後、メッセージは送信済みアイテム フォルダーに保存されます。 |
| メッセージの移動 | message | メッセージをフォルダーに移動します。 これにより、宛先フォルダーにメッセージの新しいコピーが作成されます。 |
| メッセージに返信する | なし | メッセージの送信者に返信します。 その後、メッセージは [送信済みアイテム] フォルダーに保存されます。 |
| メッセージへの応答すべて | なし | メッセージの受信者すべてに返信します。 その後、メッセージは [送信済みアイテム] フォルダーに保存されます。 |
| 下書きメッセージを送信する | なし | 以前に作成したメッセージの下書きを送信します。 その後、メッセージは送信済みアイテム フォルダーに保存されます。 |
| 添付ファイル | ||
| 添付ファイルを一覧表示する | attachment コレクション | eventMessage のすべての添付ファイルを取得します。 |
| 添付ファイルを追加する | attachment | 添付ファイル コレクションへの投稿により、eventMessage に新しい添付ファイルを追加します。 |
| オープン拡張機能 | ||
| Create open extension | openTypeExtension | オープン拡張機能を作成し、リソースの新規または既存のインスタンスのカスタム プロパティを追加します。 |
| オープン拡張機能を取得する | openTypeExtension コレクション | 名前や完全修飾名によって識別されたオープン拡張機能オブジェクトを 1 つまたは複数取得します。 |
| 拡張プロパティ | ||
| 単一値のプロパティを作成する | eventMessage | 新規または既存の eventMessage に、1 つ以上の単一値の拡張プロパティを作成します。 |
| 単一値のプロパティを取得する | eventMessage |
$expand または $filter を使用して、単一値の拡張プロパティを含む eventMessage を取得します。 |
| 複数値プロパティをCreateする | eventMessage | 新規または既存の eventMessage に、1 つ以上の複数値の拡張プロパティを作成します。 |
| 複数値プロパティを取得する | 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"
}