次の方法で共有


メッセージを更新する

名前空間: microsoft.graph

メッセージ オブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Mail.ReadWrite
委任 (個人用 Microsoft アカウント) Mail.ReadWrite
アプリケーション Mail.ReadWrite

HTTP 要求

PATCH /me/messages/{id}
PATCH /users/{id | userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

要求ヘッダー

名前 種類 説明
Authorization string ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type string エンティティ本文内のデータの性質です。 必須です。

要求本文

要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。 最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。 次のプロパティを更新できます。

プロパティ 種類 説明
bccRecipients 受信者 メッセージの BCC 受信者。
body ItemBody メッセージの本文。 isDraft = true の場合にのみ更新可能です。
categories String collection メッセージに関連付けられたカテゴリ。
ccRecipients 受信者コレクション メッセージの CC 受信者。
flag followUpFlag メッセージのステータス、開始日、期限、または完了日を示すフラグ値。
from 受信者 メッセージのメールボックス所有者と送信者。 実際に使用されているメールボックスに対応している必要があります。
importance String メッセージの重要度です。 使用可能な値: LowNormalHigh
inferenceClassification String 推定される関連性や重要性、または明示的なオーバーライドに基づく、ユーザーのメッセージの分類。 使用可能な値: focusedother
internetMessageId String RFC2822 によって指定された形式のメッセージ ID。 isDraft = true の場合にのみ更新可能です。
isDeliveryReceiptRequested Boolean メッセージの開封応答が要求されているかどうかを示します。
isRead Boolean メッセージが開封されたかどうかを示します。
isReadReceiptRequested Boolean メッセージの開封確認メッセージが要求されているかどうかを示します。
multiValueExtendedProperties multiValueLegacyExtendedProperty コレクション メッセージに対して定義された、複数値の拡張プロパティのコレクション。 Null 許容型です。
replyTo 受信者コレクション 返信時に使用される電子メール アドレス。 isDraft = true の場合にのみ更新可能です。
sender 受信者 メッセージを生成するために実際に使用されるアカウント。 共有メールボックスからメッセージを送信するとき、またはメッセージを delegate として送信するときに、更新可能です。 いずれの場合でも、この値は、実際に使用されているメールボックスに対応している必要があります。
singleValueExtendedProperties singleValueLegacyExtendedProperty コレクション メッセージに対して定義された、単一値の拡張プロパティのコレクションです。 Null 許容型です。
subject String メッセージの件名。 isDraft = true の場合にのみ更新可能です。
toRecipients 受信者コレクション メッセージの宛先受信者。

メッセージ リソースは拡張機能をサポートしているため、PATCH 操作を使用して、既存のメッセージ インスタンスで拡張機能のカスタム プロパティにあるアプリ固有のデータを追加、更新、または削除することができます。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された message オブジェクトを返します。

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json

{
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "inferenceClassification": "other"
}
応答

次の例は応答を示しています。 注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value",
  "inferenceClassification": "other"
}