メッセージを更新する

名前空間: microsoft.graph

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

アクセス許可

この 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	メッセージの重要度です。 使用可能な値: Low、Normal、High。
inferenceClassification	String	推定される関連性や重要性、または明示的なオーバーライドに基づく、ユーザーのメッセージの分類。使用可能な値は、focused または other です。
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 オブジェクトを返します。

例

要求

以下は、要求の例です。

HTTP

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

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

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var message = new Message
{
    Subject = "subject-value",
    Body = new ItemBody
    {
        ContentType = BodyType.Text,
        Content = "content-value"
    },
    InferenceClassification = InferenceClassificationType.Other
};

await graphClient.Me.Messages["{message-id}"]
    .Request()
    .UpdateAsync(message);

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const message = {
  subject: 'subject-value',
  body: {
    contentType: '',
    content: 'content-value'
  },
  inferenceClassification: 'other'
};

await client.api('/me/messages/{id}')
    .update(message);

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

Message message = new Message();
message.subject = "subject-value";
ItemBody body = new ItemBody();
body.contentType = BodyType.TEXT;
body.content = "content-value";
message.body = body;
message.inferenceClassification = InferenceClassificationType.OTHER;

graphClient.me().messages("{id}")
    .buildRequest()
    .patch(message);

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewMessage()
subject := "subject-value"
requestBody.SetSubject(&subject)
body := msgraphsdk.NewItemBody()
requestBody.SetBody(body)
contentType := ""
body.SetContentType(&contentType)
content := "content-value"
body.SetContent(&content)
inferenceClassification := "other"
requestBody.SetInferenceClassification(&inferenceClassification)
messageId := "message-id"
graphClient.Me().MessagesById(&messageId).Patch(requestBody)

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

PowerShell

Import-Module Microsoft.Graph.Mail

$params = @{
    Subject = "subject-value"
    Body = @{
        ContentType = ""
        Content = "content-value"
    }
    InferenceClassification = "other"
}

# A UPN can also be used as -UserId.
Update-MgUserMessage -UserId $userId -MessageId $messageId -BodyParameter $params

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

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

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"
}

関連項目

• 拡張機能を使用してカスタム データをリソースに追加する
• オープン拡張機能を使用したユーザーへのカスタム データの追加 (プレビュー)